使用说明
日本政府
日本政府API集成 MCP（模型上下文协议）. 通过14个工具实现36个API，这些工具具有智能代码解析、数据连接和上下文分析功能。
合并日本中央省厅API的MCP服务器。36个API可通过14个工具78个动作进行操作。
特性
- 14个工具/78个动作 --政府统计（e-Stat）、企业数据、天气、立法、地理空间、学术资源等
- 代码解析 —natural language“东京の出生率”auto-resolves to API parameters
- 数据加入 --通过单位归一化在时间/面积轴上连接多个源
- 上下文分析 --“该值在过去30年中处于第N百分位”
- AI建议 --基于上下文的下一步建议
- 1918个城市+10669个EDINET实体 内置静态字典
- 663次测试/0次失败 --包括Codex AI用户模拟测试
快速开始
安装
git clone https://github.com/Rei02061986/japan-gov-mcp.git
cd japan-gov-mcp
npm install
npm run build
环境变量
# Required (enables core statistics features)
export ESTAT_APP_ID=your_estat_app_id # https://www.e-stat.go.jp/api/
# Optional (enable additional APIs as needed)
export HOUJIN_APP_ID=... # Corporate number API
export GBIZ_TOKEN=... # gBizINFO
export EDINET_API_KEY=... # EDINET financial filings
export MLIT_DPF_API_KEY=... # MLIT Data Platform
export REALESTATE_API_KEY=...# Real estate information
export HELLOWORK_API_KEY=... # HelloWork job listings
许多工具都有效 没有任何API密钥：天气、立法、地理空间、学术搜索、日本央行统计数据、国家开发银行健康数据等。
Claude桌面配置
添加 claude_desktop_config.json:
{
"mcpServers": {
"japan-gov": {
"command": "node",
"args": ["/path/to/japan-gov-mcp/build/index.js"],
"env": {
"ESTAT_APP_ID": "your_estat_app_id"
}
}
}
}
工具
数据检索（工具1-9）
| # | 工具 | 描述 | 关键API |
|---|---|---|---|
| 1 | estat |
政府统计搜索/检索 | e-Stat API |
| 2 | stats |
经济指标，日本央行，NDB健康状况 | 统计仪表板，日本银行，NDB |
| 3 | corporate |
公司信息 | 公司编号、gBiz、EDINET |
| 4 | weather |
天气和防灾 | JMA、J-SHIS、洪水/河流数据 |
| 5 | law |
立法和议会记录 | 电子法律、国会会议记录、公众评论 |
| 6 | geo |
地理空间数据 | GSI地理编码，PLATEAU 3D城市模型 |
| 7 | academic |
学术和文化资源 | NDL、J-STAGE、CiNii、JapanSearch |
| 8 | opendata |
开放数据目录 | data.go.jp，G-space |
| 9 | misc |
其他政府数据 | 旅行安全、采购、房地产、土地价格、就业 |
分析层（工具10-14）
| # | 工具 | 描述 | 关键操作 |
|---|---|---|---|
| 10 | resolve |
代码解析和ID桥接 | code_lookup, entity_bridge, area_bridge, time_bridge |
| 11 | navigate |
数据目录探索 | recommend, schema, coverage |
| 12 | join |
数据连接和规范化 | fetch_aligned, normalize, fill_gaps |
| 13 | context |
背景分析和建议 | percentile, peers, trend_context, annotate, suggest |
用法示例
出生率下降分析（4步）
1. navigate.recommend("少子化")
→ Recommends: birthrate, marriage rate, childcare waiting lists
2. resolve.area_bridge(all prefectures)
→ Unified area codes across APIs
3. join.fetch_aligned([birthrate, land_prices])
→ Joined table for 47 prefectures
4. context.annotate(joined_table)
→ Tokyo: worst rank, Okinawa: #1, alerts for historic lows + next-step suggestions
跨API公司查找
resolve.entity_bridge("トヨタ自動車")
→ { corporateNumber: "2180001...", edinetCode: "E02144", gbizAvailable: true }
统计的历史背景
context.percentile({ source: "estat", indicator: "出生率", value: 1.20, area: "13" })
→ { percentile: 3.2, rank: "46/47", alert: "過去最低水準", historicalRange: "1.20-2.14" }
API覆盖范围
不需要API密钥
| 类别 | API |
|---|---|
| 统计 | 统计仪表板、日本央行时间序列、NDB健康数据 |
| 天气 | JMA预报，台风，AMeDAS，J-SHIS地震危险，洪水/河流 |
| 立法 | 电子法律、国会会议记录、公众评论 |
| 地理空间 | GSI地理编码、地理形状边界、PLATEAU 3D |
| 学术 | NDL、J-STAGE、CiNii、Japan Search、AgriKnowledge |
| 科学 | Soramame空气质量，地质调查，日本宇宙航空研究开发机构卫星 |
| 政府 | 旅行安全、饮食记录、采购 |
| 目录 | data.go.jp，G-Space |
需要API密钥
| API | 提供程序 | 环境变量 | 注册 |
|---|---|---|---|
| e-Stat | 内政部 | ESTAT_APP_ID |
https://www.e-stat.go.jp/api/ |
| 公司编号 | 国家税务局 | HOUJIN_APP_ID |
https://www.houjin-bangou.nta.go.jp/webapi/ |
| gBizINFO | 经济产业省 | GBIZ_TOKEN |
https://info.gbiz.go.jp/hojin/api |
| EDINET | FSA | EDINET_API_KEY |
https://disclosure2.edinet-fsa.go.jp/ |
| MLIT数据平台 | MLIT_DPF_API_KEY |
https://www.mlit-data.jp/ | |
| 房地产 | MLIT | REALESTATE_API_KEY |
https://www.reinfolib.mlit.go.jp/ |
| HelloWork | 厚生劳动省 | HELLOWORK_API_KEY |
https://www.hellowork.mhlw.go.jp/ |
所有API密钥都是 自由 以获得。
测试
npm test # Unit tests (421)
npm run test:e2e # E2E tests (242)
npm run test:all # All tests (663)
日志记录
所有工具调用都以JSONL格式自动记录。
# Most called tools
cat ~/.japan-gov-mcp/logs/*.jsonl | jq -r .tool | sort | uniq -c | sort -rn
# Errors only
cat ~/.japan-gov-mcp/logs/*.jsonl | jq 'select(.status=="error")'
禁用日志记录： JAPAN_GOV_MCP_LOG=false
规格
有关完整的技术规格，请参阅 SPEC-v3.3.md. 将此文件传递给另一个AI，使其完全理解所有14个工具和78个操作。
发展
npm run build # TypeScript compile
npm run typecheck # Type check only
npm test # Run tests
npm run inspect # MCP Inspector GUI
数据来源和信用
该项目整合了来自以下日本政府API的数据。所有数据使用均符合每个提供商的服务条款。
许可证框架
大多数日本政府API使用以下标准许可证之一：
| 许可证 | 兼容CC BY 4.0 | 商业用途 |
|---|---|---|
| 政府标准利用规约（第2.0版） | 是 | 是 |
| 公共数据使用条款PDL1.0 | 是 | 是 |
必修学分
使用这些API的数据时，需要以下信用声明：
电子统计：此服务使用政府统计信息综合窗口（e-Stat）的API功能，但服务内容不受国家担保。
统计仪表板：此服务使用统计仪表板上的API功能，但服务内容不受国家/地区的保证。
BOJ时系列统计：此服务使用日本银行时间系列统计数据搜索网站的API功能。服务的内容不是日本银行保证的。
法人番号：该服务是根据利用国税厅法人编号系统Web-API功能取得的信息制作的，但服务的内容不是国税厅保证的。
房地产信息库：此服务使用国土交通省房地产信息库的API功能，但不保证提供信息的最新性、准确性、完整性等。
MLIT DPF：此服务使用国土交通数据平台的API功能，但不保证最新数据。
数据提供程序
| 提供商 | API | 许可证 |
|---|---|---|
| 总务省｜e-Stat，统计仪表盘｜政府标准使用条款2.0/PDL1.0｜ | ||
| 日本银行 | BOJ时系列统计 | 独自规约 |
| 厚生劳动省：NDB开放数据 | ||
| 国税庁 | 法人番号 | 独自規約 |
| ｜经济产业省/数字厅｜gBizinFO｜政府标准使用条款2.0｜ | ||
| 金融庁 | EDINET | PDL 1.0 |
| 气象庁 | 天气予报，地震・津波 | 政府标准利用规约2.0 |
| 防灾科研 | J-SHIS | 独自规约 |
| 国土地理院，浸水导航系统，浸水导航系统，浸水导航系统 | ||
| 日本道路交通信息中心 | ||
| ｜数字厅｜e-Laws法令API｜政府标准使用条款2.0｜ | ||
| 国立国会图书馆，国会会议录，NDL搜索 | ||
| 政府标准使用条款2.0 | ||
| 国交省 | PLATEAU，不动产，DPF | PDL 1.0 /独自 |
| JST | J-STAGE | 独自规约 |
| NII | CiNii、IRDB、Geoshape | 独自 / CC 4.0 |
| 国立国会图书馆/文化厅 | ||
| 外务省 | 海外安全情报 | PDL 1.0 |
| 环境省 | ||
| 产総研 | 地质图Navi | 政府标准利用规约2.0 |
| JAXA | JAXA Earth API | 独自规约 |
| 农研机构 | AgriKnowledge | 独自规约（非营利のみ） |
| 中小企业厅 |
有关完整的使用条款分析，请参阅 报告-飞行员.md.
免责声明
- 这个项目是 不隶属于或认可 日本政府或其任何机构。
- 所有数据均从公开的政府API中检索。 不保证准确性、完整性和可用性。
- 政府API可能会更改、限制或停止，恕不另行通知。
- 此软件按“原样”提供——请参阅 许可证 了解详情。
- 不要将政府统计数据作为关键决策的唯一依据 未经官方消息来源核实。
- 每个API的数据都受该提供商的使用条款约束。此MCP服务器的用户在使用检索到的数据时有责任遵守适用条款。
本项目是与日本政府、各省厅无关的非正式工具。不保证捕获数据的准确性、完整性和可用性。政府API可能会在没有预告的情况下变更、停止。重要决策一定要确认官方消息来源。每个API的数据都遵循各自供应商的使用条款。
许可证
麻省理工学院
贡献
欢迎拉取请求。通过Issues提交错误报告和功能请求。
