当前位置：首页 > news >正文

维智 MCP 接口服务技术支持指南

news 2026/6/3 0:35:07

（一）服务概述

维智 MCP Server 基于标准化 MCP 协议，整合丰富地理信息数据，为智能体提供地点搜索、正 / 逆地理编码、IP 定位解析、天气查询四大核心能力。数据覆盖城市级、街道级、坐标级查询，支持 HTTP/SSE 双传输协议，可快速适配 VSCode、Cursor、各类编程语言开发环境，助力智能体高效实现地理信息相关功能。

（二）快速接入指南

1. 核心前提准备

申请 API Key：所有接口均需通过 API-Key 鉴权，需先在维智平台申请应用 access_key，该 Key 为接口调用的唯一权限凭证。
环境要求：支持 MCP 协议的客户端（VSCode、Cursor、Browser MCP Client）或各类编程语言的 MCP SDK，推荐使用 Python FastMCP Client 快速集成。

2. 客户端配置说明

（1）标准 MCP 客户端配置（适用于 VSCode/Cursor）

在客户端配置文件中添加如下 JSON 配置，替换 YOUR_ACCESS_KEY 为实际申请的 API Key：

{ "mcpServers": { "wayz-lot-mcp": { "type": "sse", "url": "https://positionboard.newayz.com/mcp", "headers": { "X-API-Key": "YOUR_ACCESS_KEY" }, "timeout": 60, "sse_read_timeout": 300 } } }

（2）Python FastMCP Client 配置示例

python 运行

from fastmcp import Client config = { "mcpServers": { "server_name": { "transport": "http", # 可选 "sse" 协议 "url": "https://positionboard.newayz.com/mcp", "headers": {"X-API-Key": ACCESS_KEY} # 替换为实际 API Key } } } client = Client(config)

3. 核心接口调用示例

（1）地理编码（地址转坐标）

python 运行

client.call_tool("geocode_tool", { "address": "北京市东城区东长安街", "city": "北京" })

（2）逆地理编码（坐标转结构化地址）

python 运行

client.call_tool("regeocode_tool", { "longitude": 116.397128, "latitude": 39.916527 })

（3）IP 定位查询

python 运行

client.call_tool("ip_location_tool", {"ip": "8.8.8.8"})

（4）天气查询（支持城市名称或 adcode）

python 运行

client.call_tool("get_weather_tool", {"name": "北京"})

（三）常见问题排查

1. 接口调用失败

检查 API Key 有效性：确认 X-API-Key 配置正确，未过期或泄露，重新申请并替换无效 Key。
网络连接问题：验证目标服务器地址（https://positionboard.newayz.com/mcp）是否可访问，调整 timeout（默认 60 秒）和 sse_read_timeout（默认 300 秒）参数。
参数格式错误：确保地址、坐标、IP、城市名称等参数符合接口要求，坐标类参数需保留正确精度。