# DataV-Atlas地理可视化
## 基本信息
- Slug: `datav-atlas-atlas-tools-mcp-server`
- Source: modelscope
- Publisher: @DataV-Atlas/atlas-tools-mcp-server
- Categories: search / developer-tools / location-services / AIGC
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@DataV-Atlas/atlas-tools-mcp-server
## 简介
DataV Atlas MCP服务是阿里云DataV团队提供的地理空间数据可视化MCP服务，提供地理空间数据的大模型可视分析能力，包含地理空间数据处理、地理空间数据生成、地理空间可视化布局算法、地理空间可视化编码工具等。
## 安装提示

```bash
#### 🌐 HTTP 模式（推荐用于生产环境和多用户场景） **启动 HTTP 服务器：** ```bash # 使用默认端口 3001 npx -y atlas-tools-mcp-server --http # 使用自定义端口 npx -y atlas-tools-mcp-server --http --port 8080
```

## MCP Server 详情

# 🗺️ Atlas GIS MCP 工具集 🚀

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

---

### ⚙️ 前置条件

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

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

工具调用需要使用 `TOKEN`进行鉴权，可前往 [Atlas 工具官网](https://atlas.datav.aliyun.com/maptool) 页面获取 Token，同时可查看最新的工具列表

### 🖥️ MCP 服务器配置

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

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

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

```json
{
  "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 服务器：**

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

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

**MCP 客户端配置：**

```json
{
  "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 请求头**：

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

3. **自定义头部**：
   ```bash
   curl -H "X-Atlas-Token: your_token" \
        http://localhost:3001/mcp
   ```

#### 🔄 HTTP 模式 vs stdio 模式

| 特性           | stdio 模式             | HTTP 模式                     |
| -------------- | ---------------------- | ----------------------------- |
| **多用户支持** | ❌ 单用户              | ✅ 多用户并发，认证隔离       |
| **部署方式**   | 每个客户端启动独立进程 | 单一服务器实例                |
| **资源消耗**   | 高（多进程）           | 低（单进程）                  |
| **网络访问**   | 仅本地                 | 支持远程访问                  |
| **负载均衡**   | 不支持                 | 支持                          |
| **监控和日志** | 分散                   | 集中化                        |
| **认证方式**   | 环境变量               | 多种方式（URL参数、请求头等） |
| **适用场景**   | 本地开发、单用户       | 生产环境、多用户、企业部署    |

#### 🚀 命令行选项

```bash
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 服务器端口
```

#### 🔒 多租户支持

**多租户场景示例：**

```bash
# 用户 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 的实际配置**

![CherryStudio 配置](https://img.alicdn.com/imgextra/i4/O1CN01QSospq24FOUodOae3_!!6000000007361-0-tps-2862-2130.jpg)

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

![CherryStudio 使用](https://img.alicdn.com/imgextra/i2/O1CN01dInIKN1oniKAS1bNc_!!6000000005270-2-tps-3190-2320.png)

### 📝 使用技巧

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

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

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

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

#### 📍 数据获取类

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

#### 🛠️ 数据生成类

| 工具名称                       | 工具描述                                                                                                                                         |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| 🎯 RandomPointsInPolygon       | **面内随机点生成工具**：在指定面内随机生成点数据，支持随机（random）分布、均匀（uniform）分布、聚类（cluster）分布                               |
| 📏 RandomPointsAlongLine       | …