tianditu

What is tianditu?

天地图 MCP Server 是天地图 API 的 MCP 协议实现，提供地理编码、逆地理编码、周边检索三个核心地图服务接口。任何支持 MCP 协议的智能体助手（如 Claude、Cursor、千帆 AppBuilder）均可快速接入，适合需要地理信息查询与位置计算的开发者。

How to use tianditu?

在天地图开放平台获取服务端 AK 后，通过 pip install mcp-tianditu 安装，然后在 MCP 客户端配置文件中添加 tianditu-map 工具，设置环境变量 TIANDITU_API_KEY。或使用 uvx mcp-tianditu 运行。具体配置格式参见 README 中的 JSON 片段。

Key features of tianditu

• 地理编码：地址转坐标，含置信度评分
• 逆地理编码：坐标转地址描述及行政区划
• 周边检索：按圆心和半径检索地点信息
• 提供行政区划编码表资源 (tdt://admin-code)
• 提供数据分类编码表资源 (tdt://data-type)
• 支持 Python 和 Typescript 两种接入方式

Use cases of tianditu

• 查询地址的经纬度坐标（如“北京市海淀区中关村”）
• 根据坐标获取详细地址和所属省市区
• 检索某地点周边指定半径内的 POI（如“天安门5公里内的博物馆”）
• 在千帆 AppBuilder 中构建出行规划助手，结合多个工具自动输出建议

FAQ from tianditu

使用天地图 MCP Server 需要什么？

需要先在天地图开放平台控制台创建服务端 AK，并在客户端配置中设置 TIANDITU_API_KEY 环境变量。

坐标采用什么系统？

所有经纬度坐标均采用国测局经纬度坐标 gcj02ll。

有哪些内置资源？

提供中国行政区划编码表 (tdt://admin-code) 和数据分类编码表 (tdt://data-type)，包含省市区编码和各类 POI 分类编码。

支持哪些 MCP 客户端？

兼容任意支持 MCP 协议的智能体助手，如 Claude、Cursor 以及千帆 AppBuilder 等。