Agent开发 - Cursor/ClaudeCode接入外部系统MCP服务

前置准备前往高德开放平台创建应用获取MCP 类型 AMAP_MAPS_API_KEY本地stdio 模式需安装 Node.js ≥v22.14.0一、Cursor安装高德地图MCP Server服务教程1. 打开Cursor进入主页面后,点击左侧栏中的Customize图标在右侧界面点击MCPs按钮2. 点击New,右侧弹出mcp.json文本框3. 在网址【Amap Maps MCP Server】找到右侧的Server Config,复制mcp.json{ mcpServers: { amap-maps: { command: npx, args: [ -y, amap/amap-maps-mcp-server ], env: { AMAP_MAPS_API_KEY: api_key } } } }4. 在高德开放平台【我的应用 | 高德控制台】中创建API_KEY:点击右上角【添加key】在配置框中填写Key名称、勾选Web服务、勾选同意并提交即可生成API_KEY在【Key】这列下面复制你的API_KEY到mcp.json中进行替换:5. 替换完API_KEY后一定要ctrl s保存mcp.json,否则新的mcp.json不生效此时Cursor内置的MCP Client自动连接并拉取Server中的tools信息如下鼠标左键单击amp-maps这个MCP Server可以看到工具信息6. 谨慎操作若有删除此MCP Server的需求点击User下面面的~/.cursor/mcp.josn即可打开mcp.josn文件全部选中删除再ctrl s保存即可卸载MCP Server可以看到MCP Server已经卸载了二、Claude Code安装高德地图MCP Server服务教程推荐使用mcp.json配置文件形式安装第2个1. 使用Claude Cli或者cmd【终端命令】安装MCP Server方式1 stdio本地npx模式(推荐将MCP Server部署在本地)1. 验证已安装Claude Cli2. 进入你要打开的项目目录位置3. 使用命令claude进入Claude Cli命令交互界面4. 使用命令claude mcp list查看所有已有的mcp服务方式1使用exit命令退出claude交互界面在cmd界面直接执行命令claude mcp list查看claude所有安装mcp server服务推荐方式2在claude交互界面使用/mcp list命令查看所有已安装的mcp server服务5. 安装高德地图MCP Server执行cmd命令claude mcp add amap-maps --env AMAP_MAPS_API_KEY你的高德平台API_KEY -- npx -y amap/amap-maps-mcp-servercmd界面使用 claude mcp list命令可以看到MCP Server连接成功了或者进入Claude Cli执行命令/mcp list,可以看到也成功安装并连接MCP Server了6. 在Claude Cli交互页面向大模型发送和地理位置有关的自然语言请求可以看到成功调用了高德地图MCP Server中的工具们最终结果如下总结 使用本地stdio模式将MCP Server部署在本地若你使用Vs Code接入了Claude Code推荐不要使用cmd命令而是用Cli命令将cluade mcp 替换为内置的 /mcp 命令这样我们直接在VsCode中直接使用Claude 内置命令很方便。方式2高德远程 Streamable HTTP/SSE 模式无需本地 Node调用远程已部署好的MCP Servercmdclaude mcp add --transport sse amap-maps https://mcp.amap.com/sse --header X-API-Key:你的高德key2. 使用mcp.json安装MCP Server【配置文件】形式⭐推荐因为MCP Server在mcp.so平台中都有提供mcp.json例如高德地图MCP Server直接复制Server Config中的mcp.json更改API_KEY即可全局所有项目生效~/.claude.jsonMac/Linux、%USERPROFILE%\.claude.jsonWindows项目级仅当前项目优先级更高项目根目录.mcp.json我测试的这个全局可自己测试Claude Code 识别优先级顺序项目根目录.mcp.json 全局%USERPROFILE%\.claude.json本地stdio安装MCP Server推荐json{ mcpServers: { amap-maps: { command: npx, args: [-y, amap/amap-maps-mcp-server], env: { AMAP_MAPS_API_KEY: 你的高德key } } } }远程 SSE 版本配置除非特别需要远程第三方MCP Server又不想部署到本地json{ mcpServers: { amap-maps: { type: http, url: https://mcp.amap.com/sse, headers: { X-API-Key: 你的高德key } } } }生效与验证保存配置后重启 Claude Code⭐一定要重启才会刷新并发现MCP2. 直接提问测试例如查询望京 SOHO 的经纬度、北京到天津驾车路线3. 原理Claude Code 作为 MCP Host内置 MCP Client初始化时发起initialize握手、tools/list拉取高德全部地图工具大模型自主决策调用对应地图能力3. 如何卸载高德地图MCP Server若有卸载需求时方式 1推荐CMD 顶层直接执行不要进 claude REPL 聊天里cmdclaude mcp remove amap-maps如果当时添加时指定了--scope user或者--scope project带上 scopecmdclaude mcp remove amap-maps --scope usercmdclaude mcp remove amap-maps --scope project执行完成后校验是否删除成功cmdclaude mcp list方式 2如果你已经在 claude REPL 对话内部直接输入斜杠指令plaintext/mcp remove amap-maps方式3 兜底手动删除配置命令失效时使用删除配置文件即可npx 方式安装的amap/amap-maps-mcp-server不会全局留存包文件每次都是临时拉取只需要删掉配置mcp.json即可找到 Claude Code 配置文件全局 (user)%APPDATA%\Claude\config.json项目级 (project)当前目录.mcp.json在mcpServers节点里删掉整个 amap-maps 的 json 块保存文件重启claude⚠️补充说明amap/amap-maps-mcp-server是 npx 动态拉起的包不需要 npm uninstall没有本地常驻安装文件只需要从 claude 配置里移除这个服务记录就算卸载完成。