内容
# 地理分析 MCP
用于读取、分析和制图矢量空间数据的MCP服务器，与Claude Desktop集成。从自然语言指令到专业地图，无需打开桌面GIS。
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `list_layers` | 列出空间文件的图层，包含几何类型、要素数量和CRS |
| `get_layer_schema` | 完整的图层模式：字段、类型、边界框、CRS |
| `scan_field_stats` | 按字段（数值和分类）描述性统计 |
| `read_features` | 读取要素为GeoJSON FeatureCollection，支持WHERE过滤和边界框 |
| `preview_geometries` | WKT几何预览 |
| `render_map` | 交互式Leaflet地图（平移/缩放，点击属性，多图层切换，图例，比例尺） |
| `export_map_image` | 地图图像（JPG/PNG/PDF/SVG）包含底图、符号、图例、比例尺、方向和标注 |
| `export_map_cartographic` | 正式制图产品：标题、侧面板包含图例和位置索引、比例尺、方向和坐标网格 |
**跨工具能力**（适用于三项地图工具）：
- **多图层** — `extra_layers`叠加额外图层，自定义颜色、线型、透明度和标签 |
- **符号系统** — `color_by`快速分类，或`style`高级分类/渐变（颜色坡度和类别切割） |
- **自定义底图** — `basemap`接受ArcGIS MapServer瓦片或XYZ模板 `{z}/{x}/{y}`；默认CartoDB Positron |
- **过滤器** — `where`（SQL OGR）和`bbox`；`where`地图范围调整为过滤要素 |
- **CRS** — 自动重投影到WGS84；`source_crs` / `crs`适用于未声明参考系的文件 |
- **标注** — `label_by`按字段标注要素，智能放置 |
**支持格式：** FileGDB（`.gdb`）、Shapefile（`.shp`）、GeoJSON、GeoPackage（`.gpkg`）、KML和GDAL/OGR兼容的矢量格式。
## 在Claude Desktop安装（推荐）
需要 [uv](https://docs.astral.sh/uv/) 已安装。
1. 从 [Releases](https://github.com/alexrobl/geoanalisis-mcp/releases) 下载 `geoanalisis-mcp-X.Y.Z.mcpb`
2. 用Claude Desktop打开（双击或 *配置 → 扩展 → 安装扩展*）
3. 完成 — 依赖项将自动通过uv在首次启动时解决
从源代码生成bundle：
```bash
npx @anthropic-ai/mcpb pack . geoanalisis-mcp.mcpb
```
## 手动安装（开发）
需要Python ≥ 3.11和 [uv](https://docs.astral.sh/uv/)。
```bash
git clone https://github.com/alexrobl/geoanalisis-mcp
cd geoanalisis-mcp
uv sync
```
将以下内容添加到 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"geoanalisis": {
"command": "/path/to/repo/.venv/bin/geoanalisis-mcp"
}
}
}
```
## render_map
在Claude中直接生成交互式HTML产物，使用Leaflet，具有双重输出：
- **聊天窗口内联** — 平移、缩放，点击要素查看属性，图层控制切换，图例，比例尺和坐标。 在Claude的沙盒中，外部瓦片被阻止，因此背景显示为灰色。
- **磁盘高保真** — 此外保存一个HTML（`{layer}_dynamic.html`），在浏览器中打开时底图会加载。
数据服务器端嵌入（如果超过`limit`，则均匀采样），不消耗对话上下文。
## export_map_image 和 export_map_cartographic
服务器端使用matplotlib + contextily生成图像：在聊天窗口内联显示（72 DPI），并以高分辨率保存（`dpi`可配置；`dpi > 150`时，底图瓦片请求更大的缩放级别以保持清晰）。两者都返回应用到每层的符号实际文本报告。
- `export_map_image` — 快速审查视图：图例、比例尺、方向和可选署名。输出 `.png`、`.jpg`、`.pdf`（矢量）或 `.svg`。
- `export_map_cartographic` — 正式交付产品：机构标题、侧面板包含图例、约定和位置索引、下方条带包含方向、比例尺和字体。建议 `.jpg` 用于工作，`.pdf` 用于交付。
