🗺️ Atlas GIS MCP 工具集 🚀

Atlas GIS MCP 工具集由 DataV 团队打造，专为大模型智能处理地理空间数据所设计，包含地理编码、路径规划、空间数据生成与处理、行政区划解析等常见 GIS 工具。

---

⚙️ 前置条件

开始前请确保你已获取有效 TOKEN，否则无法正常调用工具。

工具调用需要使用 TOKEN进行鉴权，可前往 Atlas 工具官网 页面获取 Token，同时可查看最新的工具列表

🖥️ MCP 服务器配置

💡 提示： 按照下方 JSON 配置即可快速集成 Atlas GIS 工具集。

1{
2  "mcpServers": {
3    "atlas-gis-tools": {
4      "name": "Atlas GIS 工具集",
5      "type": "stdio",
6      "command": "npx",
7      "args": [
8        "-y",
9        "atlas-tools-mcp-server@latest"
10      ],
11      "env": {
12        "TOKEN": "<YOUR_TOKEN_HERE>"
13      }
14    }
15  }
16}

💡 使用案例

CherryStudio 的实际配置

搭配百炼 qwen-max-latest 模型使用效果

📝 使用技巧

可以在 Agent 的系统提示词中添加如下内容，提高工具使用成功率、生成预览工具产出的地理数据链接：

1## Atlas GIS 工具使用指南
2
3### 核心原则
41. **工具链式调用**：按数据处理逻辑顺序调用工具，使用前序工具返回的 fileUrl 作为后续输入
52. **结果可视化**：工具返回 fileUrl 时，生成预览链接：https://datav.aliyun.com/portal/school/atlas/area_generator?fileUrl=<fileUrl>
63. **简明描述**：为预览链接提供简洁标签，如「省级边界」、「简化地图」、「缓冲区分析」
7
8*具体工具列表及参数请参考工具定义 Schema*

💡 支持 MCP Prompts 的客户端

对于支持 MCP Prompts 能力的客户端（如 Claude Desktop、CherryStudio 等），本工具集提供了 preview-geo 提示词，包含了完整的工具使用指南。您可以直接调用该提示词，无需手动复制上述内容到系统提示词中。

📚 附：工具列表（持续更新中）

以下是目前支持的主要工具，持续扩充中，欢迎关注！

📍 数据获取类

工具名称	工具描述
🧭 GeoCoding	地理编码工具：用于将地址转换为地理坐标
🗺️ NearbySearch	周边POI搜索工具：根据中心点坐标，在指定半径范围内搜索周边的POI信息，返回GeoJSON格式的POI数据，包含名称、地址、营业时间、评分等信息
🚗 Routing	地图路径规划工具：根据起点、终点和可选途径点规划最佳路线，支持驾车、步行、骑行和电动车模式。返回GeoJSON格式的路径数据。注意：途径点功能仅在驾车模式下可用，最多支持16个途径点
🏷️ AdcodeToGeojson	行政区划数据获取工具：根据中国行政区划代码（必须六位编码，多个用英文逗号分隔）获取对应的 GeoJSON 数据。支持省、市、区级别。若需包含所有子级区域，可在编码后加 _full，例如：330000_full 表示获取浙江省所有子级区划
📋 GeoJsonPick	GeoJSON要素选取工具：从文件URL中按索引范围提取指定要素，支持选择性包含属性字段，最大支持1000条记录

🛠️ 数据生成类

工具名称	工具描述
🎯 RandomPointsInPolygon	面内随机点生成工具：在指定面内随机生成点数据，支持随机（random）分布、均匀（uniform）分布、聚类（cluster）分布
📏 RandomPointsAlongLine	线周围随机点生成工具：沿线段周围指定距离内随机生成点数据
🕸️ Fishnet	矩形网格生成工具：在指定输入要素数据中根据指定边长创建矩形渔网网格
🟡 DotDensity	点密度地图生成工具：创建点密度地图，在多边形内部随机分布点来表示数量信息，点的数量与指定字段的数值成比例，常用于人口分布、疾病分布等专题地图
⚫ InterpolatedPointsAlongLine	线上插值点生成工具：沿线要素按指定距离间隔生成插值点，支持各种要素类型（非线要素自动转换），距离单位为米

🧰 数据处理类

工具名称	工具描述
✂️ Simplify	几何简化工具：简化线或面地理要素数据，在保持基本形状的同时显著减少数据大小
🧩 Dissolve	区域融合工具：将具有相邻边界的地理要素融合为统一要素，消除内部边界。支持基于属性字段分组融合，主要用于行政区域合并、边界简化等场景。注意：用于融合单个数据源内的相邻要素，限制：仅支持线、面要素，要素需具有共享边界
➕ AddField	字段添加工具：为地理要素数据添加新字段，支持 JavaScript 表达式计算字段值，可基于现有属性、几何特征进行计算，适用于数据增强、属性计算等场景
🔍 FilterFeatures	要素筛选工具：根据JavaScript布尔表达式筛选地理要素，支持基于属性值、几何特征进行复杂条件筛选，适用于数据过滤、条件查询等场景
➡️ ConvertToLine	点/多边形转线工具：将点或多边形要素转换为线要素，支持按字段分组。
⬛ ConvertToPolygon	线/点转面工具：将线或点要素转换为面要素。

🔄 数据转换类

工具名称	工具描述
🔧 GeoFormatConverter	地理数据格式转换工具：支持将Shapefile、TopoJSON、KML、CSV等格式转换为GeoJSON。自动识别文件格式，CSV文件需指定经纬度字段名称，可配合FileUrlContentReader预览文件内容选择合适字段
🔗 MergeGeoFile	多文件合并工具：将多个独立的地理数据文件合并为统一的GeoJSON文件。支持Shapefile、GeoJSON、TopoJSON、KML、CSV等格式。注意：用于合并多个文件，不是融合单个文件内的要素。限制：只有相同几何类型的图层才能合并

🔧 辅助工具类

工具名称	工具描述
📄 FileUrlContentReader	URL内容读取工具：读取指定URL文件的前N个字节内容，自动检测字符编码并解析文本，常用于预览CSV文件头部以识别字段名
🖼️ SvgRender	地理数据渲染工具：对单个地理数据文件进行 SVG/PNG 渲染，支持多种样式、符号、标签和主流地图投影，适合快速预览与导出。
🗺️ CreateMap	地图可视化生成工具：可综合多个地理数据文件，生成临时地图可视化项目预览，支持多图层、样式配置与交互，适合项目级地图展示。

🔍 空间分析类

工具名称	工具描述
🔵 Buffer	缓冲区分析工具：为地理要素数据创建缓冲区，支持点、线、面要素，可指定缓冲区半径和距离单位（米或千米）
🏷️ SymbolPoint	多边形标注点工具：计算多边形的最佳标注点位置，生成的点位于多边形内部，可用于放置标签、图标或进行空间分析，确保标注内容不会超出多边形边界
🪢 InnerLines	共享边界提取工具：提取多边形之间的共享边界，创建不含属性数据的线图层，可用于获取行政区划之间的边界线、分析相邻区域的接壤情况等
🟢 TrackSurface	轨迹面生成工具：通过轨迹点生成轨迹面，支持设置半径参数。

---

❓ 常见问题解答（FAQ）

Q: 工具调用失败怎么办？

检查 TOKEN 是否正确并有效、网络是否畅通，以及客户端工具输出的详细报错信息进行排查。

Q: 如何获取最新工具列表？

访问 Atlas 工具官网 查看最新支持工具。

Q: 结果数据如何预览？

将工具生成的 fileUrl 链接按照规则拼接 https://datav.aliyun.com/portal/school/atlas/area_generator/?fileUrl=<fileUrl> 即可预览。

Q: 生成的文件会保存多长时间？

工具生成的文件为临时文件，仅保留一天（24小时）。请在文件过期前及时下载并保存到本地，避免数据丢失。

如有更多疑问，欢迎通过 Atlas 工具官网 联系我们！

---

🗒️ Release Notes

• 2025-07-10：
  • 新增 ➡️ ConvertToLine 工具，支持点/多边形转线，支持分组。
  • 新增 ⬛ ConvertToPolygon 工具，支持线/点转面。
  • 新增 🟢 TrackSurface 工具，支持轨迹点生成轨迹面，支持设置半径参数。
• 2025-07-08：
  • 新增 🖼️ SvgRender 工具，支持对单个地理数据文件进行 SVG/PNG 渲染与多样样式配置。
  • 新增 🗺️ CreateMap 工具，支持综合多个地理数据文件生成临时地图可视化项目预览，适合多图层项目级地图展示。