🗺️ 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 提示词，包含了完整的工具使用指南。您可以直接调用该提示词，无需手动复制上述内容到系统提示词中。

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

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

📍 数据获取类

🛠️ 数据生成类