Gis Accessibility MCP

GIS可访问性MCP

以韩国邑面洞为单位的 医疗、设施接近性分析可以像在Claude中对话一样执行的模型上下文协议（MCP）服务器。

此服务器与Claude Desktop和Claude Code（CLI）一起工作。

______________________________________________________________________

支持分析指标

指标选择标准为 Ahn等人（2026年） 论文和 GIS-ACCESSIBILITY-SKILL.zip 我 references/methodology.md 参考。

______________________________________________________________________

快速启动（Quick Start）

0、前提条件

必须安装以下所有软件。

Claude Desktop和Claude Code CLI 就一个 你可以留下。 即使没有Node.js，核心分析功能也能正常工作，但需要Claude直接读取结果文件。

要验证Git安装：

git --version
# 출력 예: git version 2.x.x

如果没有Git 安装后将终端（或PowerShell） 重新打开 请重新确认。

______________________________________________________________________

1.存储库克隆

Mac/Linux-Terminal上：

git clone https://github.com/Huijae-Kim/gis-accessibility-mcp.git
cd gis-accessibility-mcp

在Windows-PowerShell中：

Windows用户之后 install.ps1 运行图 PowerShell必须在中进行。从头开始使用PowerShell。

git clone https://github.com/Huijae-Kim/gis-accessibility-mcp.git
cd gis-accessibility-mcp

安装Git后，PowerShell将立即 git 可以使用命令。 安装后，PowerShell 重新打开 可以识别命令。

______________________________________________________________________

2.一次安装

⚠️ 请在安装前完全关闭Claude Desktop。 如果Claude Desktop正在运行，将以您自己的状态覆盖配置文件，使MCP注册无效。 - 雨衣： 菜单栏Claude图标右键→Quit/ Cmd+Q - 窗户： 右键单击系统托盘图标→退出

Mac/Linux：

bash install.sh

Windows（PowerShell）：

# 최초 1회만 실행 (스크립트 실행 권한 허용)
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

.\install.ps1

此脚本将自动：

1. Python虚拟环境（.venv）创建并安装软件包
2. 下载数据
3. 在Claude Desktop配置文件中注册MCP服务器（gis-accessibility + gis-filesystem)
4. 在Claude Code CLI中注册MCP服务器
5. 准备Skill文件（GIS-ACCESSIBILITY-SKILL.zip, ~/.claude/commands/gis-accessibility.md)

______________________________________________________________________

3.启动Claude Desktop并激活Skill

安装完成后，运行Claude Desktop。

+ →连接器上 gis-accessibility哇 gis-filesystem看到这个就正常了。（1-2分钟左右）

Skill激活方法（因环境而异）：

______________________________________________________________________

手动安装（可选）

自动安装（install.sh / install.ps1）失败或您想自己设置：

安装软件包

pip install -r requirements.txt

下载数据

_data/ 接收文件夹所需的数据文件（约260MB）。

方法A：自动下载（推荐）

python download_data.py

方法B：手动下载

这里从 data.zip下载并解压缩 _data/ 文件夹即创建完毕。 _data/ 文件夹 gis-accessibility 请转到文件夹。

所需文件列表： - POPULATION_DONG_FINAL.csv - HOSPITALS_FINAL.csv - BND_ADM_DONG_PG.shp （和相关文件） - BND_SIGUNGU_PG.shp （和相关文件）

Claude Desktop MCP手动注册

设置文件位置：

• 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

请添加以下内容：

{
  "mcpServers": {
    "gis-accessibility": {
      "command": "/절대경로/gis-accessibility/.venv/bin/python3",
      "args": ["/절대경로/gis-accessibility/gis_analysis_v7.py"]
    },
    "gis-filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/절대경로/gis-accessibility"]
    }
  }
}

Windows路径示例： "command": "C:\\Users\\사용자명\\gis-accessibility\\.venv\\Scripts\\python.exe" gis-filesystem殷克劳德 _results/ 允许您直接读取文件夹中的分析结果文件。如果没有Node.js，可以省略。

Claude Code CLI MCP手动注册

claude mcp add gis-accessibility /절대경로/.venv/bin/python3 /절대경로/gis_analysis_v7.py

Skill手动安装

Mac/Linux：

mkdir -p ~/.claude/commands
unzip -p GIS-ACCESSIBILITY-SKILL.zip "GIS-ACCESSIBILITY-SKILL/SKILL.md" > ~/.claude/commands/gis-accessibility.md

Windows（PowerShell）：

$dest = "$env:USERPROFILE\.claude\commands"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
$tmp = "$env:TEMP\gis-skill-tmp"
Expand-Archive -Path GIS-ACCESSIBILITY-SKILL.zip -DestinationPath $tmp -Force
Copy-Item "$tmp\GIS-ACCESSIBILITY-SKILL\SKILL.md" "$dest\gis-accessibility.md" -Force
Remove-Item $tmp -Recurse -Force

______________________________________________________________________

使用示例

在Claude Desktop或Claude Code中使用自然语言对话：

서울특별시 소아과 접근성을 2SFCA 방법으로 분석해줘

충청권 정신건강의학과 의료 공백 지역이 어디야?

대전광역시 내과 접근성을 PPR 지표로 빠르게 확인해줘

结果文件（地图图像、CSV） _results/ 存储在文件夹中。

______________________________________________________________________

文件结构

gis-accessibility/
├── gis_analysis_v7.py          # MCP 서버 메인 코드
├── requirements.txt             # Python 패키지 목록
├── download_data.py             # 데이터 자동 다운로드 스크립트
├── install.sh                   # 원클릭 설치 스크립트 (Mac/Linux)
├── install.ps1                  # 원클릭 설치 스크립트 (Windows PowerShell)
├── GIS-ACCESSIBILITY-SKILL.zip  # Claude Skill 파일 (Desktop + Code)
│   ├── SKILL.md                 #   Claude Code CLI용 slash command
│   ├── gis-accessibility.skill  #   Claude Desktop용 skill 파일
│   └── references/
│       └── methodology.md       #   방법론 참고 자료
├── _data/                       # 데이터 폴더 (Git 제외, 별도 다운로드)
│   ├── POPULATION_DONG_FINAL.csv
│   ├── HOSPITALS_FINAL.csv
│   ├── BND_ADM_DONG_PG.shp
│   └── BND_SIGUNGU_PG.shp
└── _results/                    # 분석 결과 저장 (자동 생성)
    ├── result_2SFCA_서울특별시_산부인과.png
    └── result_2SFCA_서울특별시_산부인과.csv

______________________________________________________________________

数据来源

• 行政区域边界：统计地理信息服务（SGIS）
• 全国医院现状：健康保险审查评价院（HIRA）公共数据
• 人口数据：行政安全部居民登记人口统计

______________________________________________________________________

相关论文

安、金、李（2026）。 *空间可达性的概念框架：将指标与城市服务决定因素相匹配*KAIST ISysE预印本。

______________________________________________________________________

许可证

该项目根据 CC BY-NC 4.0许可证. 您可以自由使用和修改此作品 非商业目的 适当的归因。 商业用途是 禁止 未经事先书面许可。

这个项目 CC BY-NC 4.0许可证 以下分发。 如果表明来源 非商业目的可自由使用和修改。 未经事先书面许可禁止商业使用可以。

______________________________________________________________________

私事

这项研究得到了 先进城市系统中心（CAUS） 韩国科学技术院（KAIST） GS E&C.

本研究 GS建设该支援的韩国科学技术院（KAIST） 原因在的支持下完成。