快速接入 MCP Server

支持 MCP 协议的客户端可以通过滴图 MCP Server 调用地图服务能力。当前推荐使用 HTTP 方式接入。

1. Cursor 接入

1.1 准备 DiDiKey

请先参考 成为开发者并创建 Key 获取 DiDiKey。

1.2 打开 Cursor 设置

安装并登录 Cursor，进入 MCP Server 配置页面，新增一个 MCP Server。

1.3 添加 MCP Server 配置

将 YOUR_DIDI_KEY 替换为你在滴图开放平台申请的 Key。

{
  "mcpServers": {
    "didimap-maps": {
      "url": "https://lbs.xiaojukeji.com/api/v2/mcp?key=YOUR_DIDI_KEY"
    }
  }
}

保存后返回 MCP Server 列表，确认 didimap-maps 状态正常，并能看到工具列表。

1.4 开始使用

在 Cursor 的 Agent 模式中输入需求，例如：

帮我规划从北京南站到首都机场的驾车路线，并说明距离和预计耗时。

或：

搜索北京国贸附近 1000 米内的咖啡厅，并把地点名称、地址和距离整理成表格。

模型会按需调用滴图 MCP 工具完成地点检索、路线规划或静态地图生成。

2. 通用 HTTP 调用

如果你正在自研 MCP Client，可直接向推荐入口发送 JSON-RPC 请求。

2.1 初始化

curl -X POST "https://lbs.xiaojukeji.com/api/v2/mcp?key=YOUR_DIDI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize"
  }'

成功响应示例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "tools": {}
    },
    "serverInfo": {
      "name": "OpenAPI MCP Server",
      "version": "1.0.0"
    }
  }
}

2.2 获取工具列表

curl -X POST "https://lbs.xiaojukeji.com/api/v2/mcp?key=YOUR_DIDI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list"
  }'

2.3 调用工具

下面示例调用驾车路线规划工具。

curl -X POST "https://lbs.xiaojukeji.com/api/v2/mcp?key=YOUR_DIDI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "maps_direction_driving",
      "arguments": {
        "origin": "116.397128,39.916527",
        "destination": "116.407396,39.904200",
        "need_geo": true
      }
    }
  }'

3. 请求格式

所有工具调用都使用统一结构：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "工具名",
    "arguments": {
      "参数名": "参数值"
    }
  }
}

4. 坐标格式

所有经纬度坐标参数均使用 经度,纬度 格式，例如：

116.397128,39.916527

经度范围为 -180 到 180，纬度范围为 -90 到 90。

5. 接入说明

当前滴图 MCP Server 以 HTTP JSON-RPC 方式提供服务。对新接入方，推荐直接使用 url 配置方式；暂不提供官方 Node.js I/O MCP 包。