简介

DataV Atlas MCP服务是阿里云DataV团队提供的地理空间数据可视化MCP服务，提供地理空间数据的大模型可视分析能力，包含地理空间数据处理、地理空间数据生成、地理空间可视化布局算法、地理空间可视化编码工具等。

简介

DataV Atlas MCP服务是阿里云DataV团队提供的地理空间数据可视化MCP服务，提供地理空间数据的大模型可视分析能力，包含地理空间数据处理、地理空间数据生成、地理空间可视化布局算法、地理空间可视化编码工具等。

🗺️ Atlas GIS MCP 工具集 🚀

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

---

⚙️ 前置条件

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

⚠️ MCP 需要 Node.js v18.x 或更高版本才能正常运行。

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

🖥️ MCP 服务器配置

Atlas GIS MCP 工具集支持两种连接方式：stdio 模式（传统方式）和 HTTP 模式（新增支持）。

📡 stdio 模式（推荐用于本地开发）

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

{
  "mcpServers": {
    "atlas-gis-tools": {
      "name": "Atlas GIS 工具集",
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "atlas-tools-mcp-server@latest"],
      "env": {
        "TOKEN": "<YOUR_TOKEN_HERE>"
      }
    }
  }
}

🌐 HTTP 模式（推荐用于生产环境和多用户场景）

启动 HTTP 服务器：

# 使用默认端口 3001
npx -y atlas-tools-mcp-server --http

# 使用自定义端口
npx -y atlas-tools-mcp-server --http --port 8080

MCP 客户端配置：

{
  "mcpServers": {
    "atlas-gis-tools": {
      "name": "Atlas GIS 工具集",
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp?token=<YOUR_TOKEN_HERE>"
    }
  }
}

认证方式：

1. URL 查询参数（推荐）：

   http://localhost:3001/mcp?token=your_token
   

2. HTTP 请求头：

   curl -H "Authorization: Bearer your_token" \
        http://localhost:3001/mcp
   

3. 自定义头部：

   curl -H "X-Atlas-Token: your_token" \
        http://localhost:3001/mcp
   

🔄 HTTP 模式 vs stdio 模式

🚀 命令行选项

npx -y atlas-tools-mcp-server [OPTIONS]

选项：
  --help, -h              显示帮助信息
  --http                  启用 HTTP 模式（默认：stdio）
  --stdio                 启用 stdio 模式（默认）
  --port, -p <number>     HTTP 服务器端口（默认：3001）

环境变量：
  TOKEN, token, ATLAS_TOKEN    Atlas API 令牌
  PORT                        HTTP 服务器端口

🔒 多租户支持

多租户场景示例：

# 用户 A 使用自己的令牌
curl -X POST "http://localhost:3001/mcp?token=user_a_token" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

# 用户 B 同时使用自己的令牌（不会相互干扰）
curl -X POST "http://localhost:3001/mcp?token=user_b_token" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

迁移指南（从 stdio 到 HTTP）：

1. 保持向后兼容：现有的 stdio 配置继续有效
2. 逐步迁移：可以同时运行 stdio 和 HTTP 模式
3. 配置更新：将 MCP 客户端配置从 stdio 改为 streamableHttp
4. 认证调整：从环境变量改为 URL 参数或请求头
5. 简化配置：只需要配置 token 参数即可

💡 使用案例

CherryStudio 的实际配置

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

📝 使用技巧

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

## Atlas GIS 工具使用指南

### 核心原则

1. **工具链式调用**：按数据处理逻辑顺序调用工具，使用前序工具返回的 fileUrl 作为后续输入
2. **结果可视化**：工具返回 fileUrl 时，生成预览链接：https://datav.aliyun.com/portal/school/atlas/area_generator?fileUrl=<fileUrl>
3. **简明描述**：为预览链接提供简洁标签，如「省级边界」、「简化地图」、「缓冲区分析」

_具体工具列表及参数请参考工具定义 Schema_

💡 支持 MCP Prompts 的客户端

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

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

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

📍 数据获取类

🛠️ 数据生成类

🧰 数据处理类

🔄 数据转换类

🔧 辅助工具类

🔍 空间分析类

---

❓ 常见问题解答（FAQ）

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

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

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

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

Q: 结果数据如何预览？

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

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

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

Q: HTTP 模式和 stdio 模式有什么区别？

HTTP 模式支持多用户并发访问，每个用户使用独立的认证信息，适合生产环境；stdio 模式适合本地开发和单用户场景。详见上方对比表格。

Q: 如何在 HTTP 模式下处理多用户认证？

HTTP 模式采用请求级认证隔离，每个请求可以通过 URL 参数、Authorization 头或自定义头部传递独立的认证信息，确保用户间的数据安全。

Q: HTTP 服务器的健康检查端点是什么？

访问 http://localhost:3001/health 可以检查服务器状态，返回 JSON 格式的健康信息。

Q: 如何从 stdio 模式迁移到 HTTP 模式？

1. 启动 HTTP 服务器：npx -y atlas-tools-mcp-server --http
2. 更新 MCP 客户端配置：将 type 从 stdio 改为 streamableHttp，url 设置为 http://localhost:3001/mcp?token=<YOUR_TOKEN>
3. 测试连接确保正常工作后，停止 stdio 模式

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

---

🗒️ Release Notes

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

服务配置

[{'mcpServers': {'atlas-gis-tools': {'args': ['-y', 'atlas-tools-mcp-server@latest'], 'command': 'npx', 'env': {'PLATFORM': 'MODELSCOPE', 'TOKEN': '<ATLAS_TOKEN>'}, 'name': 'Atlas GIS 工具集', 'type': 'stdio'}}}]

来源

• 来源：npmjs
• 链接：https://www.npmjs.com/package/atlas-tools-mcp-server