CHGIS MCP Server

CHGIS (China Historical Geographic Information System) 时空地名查询API的MCP (Model Context Protocol) 服务器wrapper。

功能特性

这个MCP服务器提供了对CHGIS历史地名数据库的访问功能，包括：

工具列表

search_place_by_id - 根据唯一ID精准查询地名
- 输入：地名ID（格式：hvd_数字）
- 输出：详细的地名信息，包括历史名称、行政区划、时间跨度、地理位置等
search_places - 分面搜索地名
- 支持多参数组合搜索：
  - name: 地名（中文、拼音等）
  - year: 历史年份（-222 至 1911）
  - feature_type: 行政等级类型（州、县、府等）
  - parent: 上级地名
  - source: 数据来源（CHGIS、RAS）
- 支持多种输出格式（JSON、XML、HTML）
get_place_historical_context - 获取地名历史沿革
- 输入：地名ID
- 输出：详细的历史隶属关系、下辖单位、时间变迁等信息

安装和使用

前置要求

Node.js >= 18.0.0
npm 或 yarn

安装步骤

克隆或下载此项目
安装依赖：
```
npm install
```

在Claude Code中配置

在Claude Code的配置文件中添加此MCP服务器：

{
  "mcpServers": {
    "chgis": {
      "command": "node",
      "args": ["/path/to/your/chgis-mcp-server/src/index.js"]
    }
  }
}

启动服务器

npm start

使用示例

1. 根据ID查询地名

// 查询婺州（hvd_32180）的详细信息
search_place_by_id({
  id: "hvd_32180",
  format: "json"
})

2. 分面搜索地名

// 搜索名称包含"晋阳"的地名
search_places({
  name: "晋阳",
  format: "json"
})

// 搜索1820年的县级行政单位
search_places({
  year: 1820,
  feature_type: "xian",
  format: "json"
})

// 多参数搜索
search_places({
  name: "庆",
  feature_type: "xian",
  year: 1420,
  parent: "Chuzhou",
  format: "json"
})

3. 获取历史沿革信息

// 获取婺州的历史沿革
get_place_historical_context({
  id: "hvd_32180"
})

数据结构说明

地名详细信息包含

基本信息：系统ID、URI、数据来源、许可证
拼写信息：多种文字的历史名称（繁体中文、简体中文、拼音等）
行政类型：行政等级名称和英文翻译
时间跨度：起始年份、结束年份
地理位置：经纬度坐标、现今位置

搜索结果包含

查询统计：显示结果数、总结果数
地名列表：每个地名的基本信息和详情链接

历史沿革包含

历史名称：不同时期的历史名称
时间跨度：存在的时间范围
隶属关系：不同历史时期的上级单位
下辖单位：管辖的下级行政单位及其时间范围

API限制和注意事项

网络依赖：此MCP服务器需要访问 http://tgaz.fudan.edu.cn 的CHGIS API
时间范围：数据库中的历史年份范围为 -222 至 1911
ID格式：地名ID格式必须为 hvd_ 开头加数字（如 hvd_32180）
字符编码：支持UTF-8编码的中文字符，无需URL编码
数据来源：主要来自CHGIS项目和RAS数据

错误处理

无效ID格式：会提示正确的ID格式
未找到记录：当搜索无结果时会返回相应提示
网络错误：会显示网络连接相关的错误信息
参数验证：会验证输入参数的有效性

数据来源

CHGIS - China Historical Geographic Information System
Temporal Gazetteer API
Harvard University & Fudan University

CHGIS MCP Server

CHGIS (China Historical Geographic Information System) 时空地名查询API的MCP (Model Context Protocol) 服务器wrapper。

功能特性

这个MCP服务器提供了对CHGIS历史地名数据库的访问功能，包括：

工具列表

search_place_by_id - 根据唯一ID精准查询地名
- 输入：地名ID（格式：hvd_数字）
- 输出：详细的地名信息，包括历史名称、行政区划、时间跨度、地理位置等
search_places - 分面搜索地名
- 支持多参数组合搜索：
  - name: 地名（中文、拼音等）
  - year: 历史年份（-222 至 1911）
  - feature_type: 行政等级类型（州、县、府等）
  - parent: 上级地名
  - source: 数据来源（CHGIS、RAS）
- 支持多种输出格式（JSON、XML、HTML）
get_place_historical_context - 获取地名历史沿革
- 输入：地名ID
- 输出：详细的历史隶属关系、下辖单位、时间变迁等信息

安装和使用

前置要求

Node.js >= 18.0.0
npm 或 yarn

安装步骤

克隆或下载此项目
安装依赖：
```
npm install
```

在Claude Code中配置

在Claude Code的配置文件中添加此MCP服务器：

{
  "mcpServers": {
    "chgis": {
      "command": "node",
      "args": ["/path/to/your/chgis-mcp-server/src/index.js"]
    }
  }
}

启动服务器

npm start

使用示例

1. 根据ID查询地名

// 查询婺州（hvd_32180）的详细信息
search_place_by_id({
  id: "hvd_32180",
  format: "json"
})

2. 分面搜索地名

// 搜索名称包含"晋阳"的地名
search_places({
  name: "晋阳",
  format: "json"
})

// 搜索1820年的县级行政单位
search_places({
  year: 1820,
  feature_type: "xian",
  format: "json"
})

// 多参数搜索
search_places({
  name: "庆",
  feature_type: "xian",
  year: 1420,
  parent: "Chuzhou",
  format: "json"
})

3. 获取历史沿革信息

// 获取婺州的历史沿革
get_place_historical_context({
  id: "hvd_32180"
})

数据结构说明

地名详细信息包含

基本信息：系统ID、URI、数据来源、许可证
拼写信息：多种文字的历史名称（繁体中文、简体中文、拼音等）
行政类型：行政等级名称和英文翻译
时间跨度：起始年份、结束年份
地理位置：经纬度坐标、现今位置

搜索结果包含

查询统计：显示结果数、总结果数
地名列表：每个地名的基本信息和详情链接

历史沿革包含

历史名称：不同时期的历史名称
时间跨度：存在的时间范围
隶属关系：不同历史时期的上级单位
下辖单位：管辖的下级行政单位及其时间范围

API限制和注意事项

网络依赖：此MCP服务器需要访问 http://tgaz.fudan.edu.cn 的CHGIS API
时间范围：数据库中的历史年份范围为 -222 至 1911
ID格式：地名ID格式必须为 hvd_ 开头加数字（如 hvd_32180）
字符编码：支持UTF-8编码的中文字符，无需URL编码
数据来源：主要来自CHGIS项目和RAS数据

错误处理

无效ID格式：会提示正确的ID格式
未找到记录：当搜索无结果时会返回相应提示
网络错误：会显示网络连接相关的错误信息
参数验证：会验证输入参数的有效性

数据来源

CHGIS - China Historical Geographic Information System
Temporal Gazetteer API
Harvard University & Fudan University