内容
# @urbankitstudio/mcp-atlas
[](https://glama.ai/mcp/servers/LEOyrh/mcp-atlas)
查询 155 个已验证的美国县级地块 ArcGIS REST 端点，以进行所有者、APN 和地址查找，遵循模型上下文协议（MCP）。
一个 [MCP](https://modelcontextprotocol.io) 服务器，为 AI 助手提供直接访问 UrbanKit Studio 的手动验证的县级地块 GIS 服务地图集。询问 Claude 或 Cursor 以查找任何覆盖县的 ArcGIS REST 端点，获取确切的所有者搜索查询 URL，并查找地块数据 — 无需了解任何关于 ArcGIS REST API 约定的知识。
**覆盖范围：** 美国 50 个州的 155 个县。
---
## 快速开始
### Claude Desktop
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"mcp-atlas": {
"command": "npx",
"args": ["-y", "@urbankitstudio/mcp-atlas"]
}
}
}
```
### Cursor
添加到 `.cursor/mcp.json`（项目根目录）或 `~/.cursor/mcp.json`（全局）：
```json
{
"mcpServers": {
"mcp-atlas": {
"command": "npx",
"args": ["-y", "@urbankitstudio/mcp-atlas"]
}
}
}
```
### 全局安装（可选）
```sh
npm install -g @urbankitstudio/mcp-atlas
```
然后使用 `mcp-atlas` 作为命令，而不是 `npx -y @urbankitstudio/mcp-atlas`。
---
## 工具
### `list_counties`
列出所有具有已验证地块 REST 端点的县。
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `state` | 字符串 | 否 | 两字母缩写（`IL`）或全名（`Illinois`） |
**示例提示：** "列出伊利诺伊州所有覆盖的县"
**示例输出：**
```
ST | 县 | 县 Slug | 覆盖范围
--------------------------------------------------------------------
IL | 凯恩 | kane-county | 所有者+APN
IL | 库克 | cook-county | 仅 APN
IL | 杜佩奇 | dupage-county | 所有者+APN
...
```
---
### `find_county`
模糊匹配县名或 5 位 FIPS 代码。返回端点 URL、可搜索字段名、所有者字段、示例查询和许可证信息。
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `query` | 字符串 | 是 | 县名（`Kane`）、县名+州（`Kane IL`）或 FIPS（`17089`） |
**示例提示：** "查找伊利诺伊州凯恩县的地块端点"
---
### `get_parcel_endpoint`
返回完整的 ArcGIS REST URL、图层索引、可搜索字段、所有者字段和特定的县的示例 `?where=…&f=json` 查询。
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `state` | 字符串 | 是 | 两字母缩写或全名 |
| `county` | 字符串 | 是 | 县名（`Kane` 或 `Kane County`） |
**示例提示：** "给我伊利诺伊州库克县的 ArcGIS REST 端点"
---
### `build_owner_query`
使用县验证的所有者/纳税人字段构造确切的 ArcGIS REST 查询 URL。使用 `UPPER(field) LIKE UPPER('%NAME%')` — 不区分大小写的部分匹配。
| 参数 | 类型 | 必需 | 描述 |
|-----------|------|----------|-------------|
| `state` | 字符串 | 是 | 两字母缩写或全名 |
| `county` | 字符串 | 是 | 县名 |
| `owner_name` | 字符串 | 是 | 所有者/纳税人姓名（部分匹配） |
**示例提示：** "在伊利诺伊州凯恩县为 'Smith' 构建 ArcGIS 查询"
**示例输出：**
```
县： 凯恩，伊利诺伊州
所有者字段： TaxName
WHERE 子句： UPPER(TaxName) LIKE UPPER('%SMITH%')
查询 URL：
https://gistech.countyofkane.org/arcgis/rest/services/KanePINList/MapServer/0/query
?where=UPPER(TaxName)%20LIKE%20UPPER('%25SMITH%25')
&outFields=PIN,TaxName,SiteAddress,SiteCity,MailingAddress
&returnGeometry=false&f=json&resultRecordCount=25
```
---
## 示例对话
> **用户：** 我正在对伊利诺伊州凯恩县的房产进行尽职调查。你能找到所有权人为 "Blackstone" 的所有地块吗？
> **Claude（使用 mcp-atlas）：**
> 1. 调用 `get_parcel_endpoint` → 获取 `gistech.countyofkane.org` URL 并确认所有者字段为 `TaxName`
> 2. 调用 `build_owner_query`，所有者姓名为 `Blackstone` → 返回一个可用的获取 URL
> 3. 可选地获取 URL 并格式化地块结果
---
## 地图集覆盖范围
地图集由 [UrbanKit Studio](https://urbankitstudio.com/parcel-atlas) 维护。所有端点都经过手动验证。具有所有者/纳税人字段的县支持基于全名的查找；仅限 PIN 的县支持 APN/地块编号查询。
完整覆盖范围地图：https://urbankitstudio.com/parcel-atlas
---
## 数据
地图集数据嵌入在包中（启动时无网络调用）。底层 `@urbankitstudio/atlas` SDK 也单独发布，供程序使用。
---
## 许可证
MIT — © Leo Yong / UrbanKit Studio
