交通信息查询工具

这是一个基于 Model Context Protocol (MCP) 的交通信息查询工具,允许 AI 模型查询实时油价和车辆限行信息。

功能特点

• 实时油价查询:支持查询全国34个省级行政区的今日油价，包括92号、95号、98号等各种标号汽油价格
• 车辆限行信息查询:可查询指定城市和日期的尾号限行信息，支持全国主要限行城市
• 智能参数处理:同时支持中文和拼音输入，自动转换为API所需格式
• 完善的错误处理:提供详细的错误信息和有效性验证
• 简单易用的接口:提供直观的工具接口,便于 AI 模型调用

环境配置

注意:需要在阿里云市场申请"今日油价"和"机动车尾号限行"API 的 APPCODE 作为 API 密钥。

使用方法

{
  "mcpServers": {
    "mcp-server/traffic-info": {
      "command": "node",
      "args": [
        "mcp-traffic-info/dist/index.js"
      ],
      "env": {
        "OIL_PRICE_API_KEY": "API的APPCODE作为API密钥"
      },
      "autoApprove": [
        "oil_price_query",
        "vehicle_limit_query"
      ]
    }
  }
}

工具功能

该工具提供两个主要功能:

1. 油价查询 (oil_price_query)

   • 输入：省份名称（支持中文或拼音）
   • 输出：该省份的今日油价信息
   • 支持范围：全国34个省级行政区（4个直辖市 + 23个省 + 5个自治区 + 2个特别行政区）
   • 示例参数：北京、beijing、广东、guangdong、内蒙古、neimenggu等

2. 车辆限行查询 (vehicle_limit_query)

   • 输入：城市名称（支持中文或拼音）和可选的查询日期
   • 输出：指定城市和日期的尾号限行信息
   • 支持范围：全国主要实施限行政策的城市
   • 主要城市：北京、上海、天津、重庆、广州、深圳、杭州、成都、西安、郑州、济南、石家庄、兰州、贵阳、南昌、长春、哈尔滨、乌鲁木齐等
   • 示例参数：北京、beijing、杭州、hangzhou、郑州、zhengzhou等

参数说明

油价查询参数

• prov（必需）：省份名称
  • 支持中文：北京、上海、广东、黑龙江等
  • 支持拼音：beijing、shanghai、guangdong、heilongjiang等

限行查询参数

• city（必需）：城市名称
  • 支持中文：北京、杭州、郑州、乌鲁木齐等
  • 支持拼音：beijing、hangzhou、zhengzhou、wulumuqi等
• date（可选）：查询日期，格式为YYYY-MM-DD，如2024-03-15。不提供则默认查询今天

示例

油价查询示例

使用中文省份名查询：

{
  "prov": "北京"
}

使用拼音省份名查询：

{
  "prov": "guangdong"
}

输出示例：

{
  "msg": "查询成功",
  "success": true,
  "code": 0,
  "data": {
    "orderNo": "...",
    "ret_code": 0,
    "list": [
      {
        "prov": "北京",
        "p0": "6.72",
        "p89": "7.23",
        "p90": "7.56",
        "p92": "7.58",
        "p93": "8.05",
        "p95": "8.07",
        "p97": "8.75",
        "p98": "9.13",
        "ct": "2024-03-15"
      }
    ]
  }
}

车辆限行查询示例

使用中文城市名查询：

{
  "city": "杭州",
  "date": "2024-03-15"
}

使用拼音城市名查询今日限行：

{
  "city": "beijing"
}

输出示例：

{
  "status": "0",
  "msg": "ok",
  "result": {
    "city": "hangzhou",
    "cityname": "杭州",
    "date": "2024-03-15",
    "week": "星期五",
    "time": ["07:00-09:00", "16:30-18:30"],
    "area": "留祥路—石祥路—石桥路—秋涛路—复兴路—老复兴路—虎跑路—满觉陇路—五老峰隧道—吉庆山隧道—梅灵北路—九里松隧道—灵溪南路—灵溪隧道—西溪路—紫金港路—文一西路—古墩路构成的围合区域内所有道路以及高架（含匝道以及附属桥梁、隧道）。",
    "summary": "限行尾号5和0", 
    "numberrule": "按尾号限行",
    "number": "5和0"
  }
}

支持的查询范围

油价查询支持省份

全国34个省级行政区，包括：

• 直辖市（4个）：北京、上海、天津、重庆
• 省份（23个）：河北、山西、辽宁、吉林、黑龙江、江苏、浙江、安徽、福建、江西、山东、河南、湖北、湖南、广东、海南、四川、贵州、云南、陕西、甘肃、青海、台湾
• 自治区（5个）：内蒙古、广西、西藏、宁夏、新疆
• 特别行政区（2个）：香港、澳门

限行查询支持城市

支持全国主要实施限行政策的城市，包括但不限于：

• 一线城市：北京、上海、广州、深圳
• 新一线城市：成都、重庆、杭州、西安、苏州、武汉、南京、天津、郑州、长沙、东莞、沈阳、青岛、合肥、佛山
• 其他重点城市：济南、石家庄、兰州、贵阳、南昌、长春、哈尔滨、乌鲁木齐、银川、西宁、呼和浩特等

错误处理

• 无效拼音输入：当输入的拼音不在支持列表中时，系统会返回错误信息并设置 isError: true
• 空数组保证：所有错误情况下，list 字段始终为空数组 []，而不是 null 或其他值
• 统一错误格式：所有错误响应都包含详细的错误信息和一致的数据结构

技术实现

• 基于 Model Context Protocol (MCP) SDK 构建
• 使用阿里云市场的今日油价和机动车尾号限行 API 获取实时数据
• 通过 stdio 传输实现与 AI 模型的通信

注意事项

• API 调用受到阿里云市场的限制,请注意使用频率
• 油价和限行信息可能会有延迟,请以官方发布为准

许可证

MIT