Korea Stats MCP

🇰🇷 韩国统计局MCP

  

用自然语言查询KOSIS统计的MCP服务器

统计局基于KOSIS OpenAPI的模型上下文协议（MCP）服务器。 Claude、Cursor、Windsurf等AI工具 自然语言韩国统计数据可以搜索和分析。

🌐 远程服务器URL： https://korea-stats-mcp-yxup.vercel.app/mcp

______________________________________________________________________

🎯 为什么要制作呢？

AI “韩国人口有多少？” 如果问，AI会回答学习数据的旧信息。 连接Korea Stats MCP 实时官方统计查询以提供准确的答案。

Before（无MCP）After（Korea Stats MCP连接） |-------------------|------------------------------| Q:韩国人口有多少？Q:韩国人口有多少？ | A:截至2023年，约5100万人。A:2024年韩国总人口为51712619人。 ✅ |

______________________________________________________________________

主要功能

______________________________________________________________________

🚀 使用方法

方法1：建议使用远程服务器（无需安装即可使用）

无需安装即可直接连接到远程MCP服务器。

克劳德桌面

claude_desktop_config.json 文件位置：

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

{
  "mcpServers": {
    "korea-stats": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://korea-stats-mcp-yxup.vercel.app/mcp"
      ]
    }
  }
}

光标

设置→MCP→Add new MCP server：

{
  "korea-stats": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://korea-stats-mcp-yxup.vercel.app/mcp"
    ]
  }
}

帆板运动

添加到MCP设置：

{
  "korea-stats": {
    "serverUrl": "https://korea-stats-mcp-yxup.vercel.app/mcp"
  }
}

______________________________________________________________________

方法2：本地安装

如果您想自己运行服务器，可以在本地安装。

步骤1:安装

# 저장소 클론
git clone https://github.com/Dayoooun/korea-stats-mcp.git
cd korea-stats-mcp

# 의존성 설치 (pnpm 권장)
pnpm install

# 빌드
pnpm run build

步骤2：连接到AI工具

克劳德桌面 (claude_desktop_config.json):

{
  "mcpServers": {
    "korea-stats": {
      "command": "node",
      "args": ["/절대경로/korea-stats-mcp/dist/index.js"]
    }
  }
}

光标 （设置→MCP Servers）：

{
  "korea-stats": {
    "command": "node",
    "args": ["/절대경로/korea-stats-mcp/dist/index.js"]
  }
}

______________________________________________________________________

方法3:Kakao PlayMCP

Kakao PlayMCP也可以在中使用。

1. 连接PlayMCP站点
2. 韩国统计mcp 搜索
3. 一键连接完成！

______________________________________________________________________

💬 使用示例

连接后用自然语言向AI提问：

"한국 인구가 몇 명이야?"
"서울 실업률 알려줘"
"최근 10년 출산율 추이 보여줘"
"GDP 성장률은?"
"부산과 대구 인구 비교해줘"
"서울 아파트가격 알려줘"
"경기도 GRDP 얼마야?"
"평균 임금 알려줘"
"2024년 10월 출생아수 알려줘"   # 월별 데이터
"서울 전세가격"                # 🆕 전세
"경기 자동차 등록대수"          # 🆕 자동차
"부산 범죄율"                  # 🆕 범죄
"외래관광객 몇 명이야?"
"교통사고 발생건수"            # 🆕 교통사고
"서울 의사수 알려줘"           # 🆕 의료

实际响应示例：

✅ "2025년 한국의 주민등록 총인구는 51,117,378명입니다."
✅ "2024년 서울의 실업률은 3%입니다."
✅ "2025년 3월 서울의 아파트매매가격지수는 99.687 (2021.6=100)입니다."
✅ "2025년 한국의 상용근로자 월평균 임금은 4,094,615원입니다."
✅ "2024년 경기의 지역내총생산(명목)은 651,417,234백만원입니다."
✅ "2025년 3월 서울의 주택전세가격지수는 94.134 (2021.6=100)입니다."
✅ "2024년 서울의 자동차 등록대수는 3,176,933대입니다."
✅ "2024년 부산의 인구 천명당 범죄발생건수는 34.4건입니다."
✅ "2025년 11월 한국의 외래관광객수는 1,596,939명입니다."
✅ "2024년 한국의 교통사고 발생건수는 168,585건입니다."
✅ "2024년 서울의 의료기관 종사 의사수는 43,547명입니다."

______________________________________________________________________

📊 支持的统计数据（83个关键字）

人口/生育/死亡

关键词说明生命周期 |--------|------|------| | 인구, 총인구 总人口数年 | 출산율, 합계출산율 合计生育率年 | 출생아수, 출생아, 조출생률 |出生统计年/季度/月 | 사망자수, 사망자, 조사망률, 사망률 |死亡统计年/季度/月 | 자연증가, 자연증가율 自然增减年/季度/月 | 기대수명, 기대여명, 평균수명 期待寿命年

婚姻/离婚

关键词说明生命周期 |--------|------|------| | 혼인율, 혼인건수, 조혼인율 |婚姻统计年/季度/月 | 이혼율, 이혼건수, 조이혼율 |离婚统计年/季度/月

雇佣/劳动

关键词说明生命周期 |--------|------|------| | 실업률 失业率（各市道支持）年 | 고용률 |就业率（按市支持）|年| | 취업자수, 취업자 就业人数年 | 실업자수, 실업자 失业人数年 | 경제활동인구, 비경제활동인구 经济活动人口年 | 임금, 월평균임금, 월급, 평균임금 |商用工人月平均工资（按市）|年

经济

关键词说明生命周期 |--------|------|------| | GDP, 국내총생산 GDP（国内生产总值）年 | GRDP, 지역내총생산 地区生产总值（按市）年 | 경제성장률, 성장률, GDP성장률 经济增长率年 | 물가, 소비자물가, 소비자물가지수 消费者物价（按市）年/月

贸易

关键词说明生命周期 |--------|------|------| | 수출액, 수출 出口额年 | 수입액, 수입 进口额年 | 무역수지 贸易收支年

房地产

关键词说明生命周期 |--------|------|------| | 주택가격, 주택매매가격, 주택가격지수 住宅交易价格指数（按市）月 | 아파트, 아파트가격, 아파트매매가격, 아파트가격지수 |公寓交易价格指数（按市）|月| | 전세, 전세가격, 전세가격지수, 주택전세 |住宅全租价格指数（按市）|月| | 아파트전세, 아파트전세가격 |公寓全租价格指数（按市）|月|

汽车/交通🆕

关键词说明生命周期 |--------|------|------| | 자동차, 자동차등록, 자동차대수 汽车登记数量（按市）年

犯罪/治安🆕

关键词说明生命周期 |--------|------|------| | 범죄, 범죄율, 범죄발생 每千人口中发生犯罪的次数（各市道）年

观光

关键词说明生命周期 |--------|------|------| | 관광객, 외래관광객, 입국자 外来游客入境人数月

交通/安全🆕

关键词说明生命周期 |--------|------|------| | 교통사고, 교통사고발생, 사고건수 交通事故发生件数（按市）年

医疗/健康

关键词说明生命周期 |--------|------|------| | 의사, 의사수, 의료인력 |医疗机构从业医生人数（按市）|年

大气环境🆕

关键词说明生命周期 |--------|------|------| | 미세먼지, PM2.5, 초미세먼지, 대기오염 |细颗粒物（PM2.5）浓度（按市）|月| | PM10 |可吸入颗粒物（PM10）浓度（按市）|月|

______________________________________________________________________

🗺️ 按地区查询

17个广域市也可以查询统计数据：

支持地区： 全国，首尔，釜山，大邱，仁川，光州，大田，蔚山，世宗，京畿，江原，忠北，忠南，全北，全南，庆北，庆南，济州

示例：

"서울 인구"
"부산 실업률"
"제주 출산율"
"경기도 고용률"
"서울 아파트가격"
"경기 GRDP"
"울산 임금"
"서울 전세가격"
"경기 자동차"
"부산 범죄율"
"서울 교통사고"           # 🆕 교통사고
"부산 의사수"             # 🆕 의료

______________________________________________________________________

📅 每月/季度查询🆕

某些统计数据可以按月份或季度进行查询：

示例：

"2024년 10월 출생아수"    # 월별 조회
"2024년 3분기 사망자수"   # 분기별 조회
"2025년 1월 주택가격"     # 월별 조회

支持统计信息： 出生人数，死亡人数，婚姻数量，离婚数量，自然增长，物价，房价，公寓价格，全租价格，游客

______________________________________________________________________

🛠️ 交付工具（8个）

核心工具

工具说明示例 |------|------|------| | quick_stats 快速查询83个关键词“失业率”“GDP”“可吸入颗粒物”“交通事故”“医生人数” | quick_trend 【时间序列趋势分析】【生育率10年趋势】

高级工具

______________________________________________________________________

🔧 开发者指南

本地开发

# 개발 모드 (watch)
pnpm run dev

# MCP Inspector로 테스트
pnpm run inspector

# E2E 테스트
node e2e-test.js

项目结构

korea-stats-mcp/
├── src/
│   ├── index.ts              # 진입점 (stdio 트랜스포트)
│   ├── server.ts             # MCP 서버 설정
│   ├── tools/                # 8개 도구 구현
│   │   ├── quickStats.ts     # 빠른 조회
│   │   ├── quickTrend.ts     # 추세 분석
│   │   └── ...
│   ├── data/
│   │   └── quickStatsParams.ts  # 83개 키워드 매핑
│   └── api/
│       └── client.ts         # KOSIS API 클라이언트
├── api/
│   └── mcp.ts                # Vercel 서버리스 (원격 MCP)
└── tests/                    # Playwright 테스트

添加新关键字

src/data/quickStatsParams.ts可以在中添加新关键字：

'새키워드': {
  orgId: '101',           // 기관 코드 (101 = 통계청)
  tableId: 'DT_XXXXX',    // 통계표 ID
  tableName: '통계표명',
  description: '설명',
  objL1: '00',            // 분류값 코드
  itemId: 'T10',          // 항목 코드
  unit: '단위',
}

______________________________________________________________________

📋 API密钥

内置API密钥，无需另行设置即可使用。

💡 使用自己的API密钥 KOSIS OpenAPI由发放 src/config/index.ts的 apiKey 请更改值。

______________________________________________________________________

🤝 贡献

欢迎您的贡献！

1. Fork此存储库
2. 创建新分支（git checkout -b feature/새기능)
3. 提交更改（git commit -m 'feat: 새 기능 추가')
4. 推送到分支（git push origin feature/새기능)
5. 创建Pull Request

贡献创意

• \[\]添加新的统计关键字
• \[\]支持英文关键字（population、unemployment等）
• \[\]地区名称全称支持（首尔特别市→首尔）
• \[\]更多测试案例

______________________________________________________________________

📄 许可证

MIT许可证 -可以自由使用、修改和分发。

______________________________________________________________________

🔗 相关链接

• KOSIS国家统计门户网站
• KOSIS OpenAPI开发指南
• 模型上下文协议
• MCP TypeScript SDK

______________________________________________________________________

💬 咨询

如果有问题或问题 请在注册。

______________________________________________________________________

Made with ❤️ for Korean Statistics

KOSIS OpenAPI 기반 | MCP Compatible