📊 e-Stat 数据下载MCP服务器（DRAFT）
⚠️ 这个项目现在是草稿版。不建议在生产环境中使用。
活用日本政府统计的综合窗口「e-Stat」APIModel Context Protocol (MCP)服务器。Claude中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。
🚀 主要机能
- 📋 统计数据搜索 -按关键字搜索统计表
- 📈 统计数据检索 -下载指定统计表的实际数据
- 📝 元数据检索 -获取统计表的项目定义和分类信息
- 🔍 实时搜索 -访问最新的政府统计数据
📦 安装和配置
1.克隆存储库
git clone https://github.com/shimizu/data-download-mcp-server-template.git
cd data-download-mcp-server-template2.安装相关性
npm install3. e-Stat API设定🔑
- 📝 e-Stat API利用登録创建帐户
- 🆔 应用程序ID获得
- 🔧 API设置关键帧：
# APIキー設定ファイルを作成
cp src/config/api-keys.example.js src/config/api-keys.js
# api-keys.jsを編集してアプリケーションIDを設定
# eStat: 'your_application_id_here' を実際のIDに変更重要: src/config/api-keys.js 表示GitHub在…之上push不受保护（受.gitignore保护）
4.服务器启动⚡
# MCPサーバーを起動
npm start
# MCP Inspectorで開発・テスト
npm run devClaude Code 在中使用
Claude Code 那么，那么 claude mcp add 在工作空间的边缘MCP注册服务器：
# プロジェクトに移動
cd /path/to/osm-geojson-mcp-server
# 実行権限を付与（初回のみ必要）
chmod +x src/index.js
# MCPサーバーを登録（ローカルスコープ）
claude mcp add osm-geojson node src/index.js
# または絶対パスで登録
claude mcp add osm-geojson [absolute path to]/e-stat-data-download-mcp-server/src/index.js了解更多信息 Claude Code MCP 文档 来修改标记元素的显示属性。
使用开始
claude启动后/mcp执行命令MCP请确认是否正确连接。
✔ connected的规格化距离的幂函数。
📊 搜索人口统计数据
人口に関する統計データを検索してください🏢 获取企业统计信息
「事業所・企業統計調査」のデータを検索して、
最新の調査結果を取得してください🌾 农业共识分析
農業センサスの統計表を検索し、
都道府県別の農家数データを取得して分析してください📈 経済统计の时系列分析
GDP関連の統計データを検索し、
過去5年間の推移を取得してグラフ化してください🛠️ 可用工具
🔍 e_stat_search
查找统计数据
参数：
searchWord(string): 搜索关键字statsField(string, optional): 统计领域代码collectArea(string, optional): 地区代码limit(number, optional): 捕获计数（1-100，默认值：10）
使用例:
{
"searchWord": "人口",
"limit": 20
}📈 e_stat_get_data
获取指定统计表的实际数据
参数：
dataSetId（字符串，必填）：統計表IDlimit(number, optional): 捕获计数（1-10000，默认值：1000）startPosition(number, optional): 取得开始位置metaGetFlg(string, optional): 元数据检索标志（Y/N）
使用例:
{
"dataSetId": "0003448237",
"limit": 500
}📝 e_stat_get_meta
获取统计表的元数据
参数：
dataSetId（字符串，必填）：統計表IDexplanationGetFlg(string, optional): 解说信息取得标志（Y/N）
使用例:
{
"dataSetId": "0003448237"
}👋 你好
简单的行为检查工具
🔗 test_连接
HTTP连接测试工具
📋 响应格式
🔍 検索结果
{
"success": true,
"data": {
"total": 150,
"count": 10,
"datasets": [
{
"@id": "0003448237",
"TITLE": "令和2年国勢調査 人口等基本集計",
"GOV_ORG": "総務省",
"STATISTICS_NAME": "国勢調査",
"CYCLE": "5年",
"SURVEY_DATE": "202010"
}
]
},
"metadata": {
"tool": "e_stat_search",
"timestamp": "2024-01-01T12:00:00.000Z"
}
}📈 统计数据
{
"success": true,
"data": {
"dataSetId": "0003448237",
"title": "令和2年国勢調査 人口等基本集計",
"dataCount": "50000",
"retrievedCount": 1000,
"data": [
{
"@unit": "人",
"@cat01": "001",
"@area": "01000",
"$": "1234567"
}
]
}
}🗂️ 项目结构
📁 e-stat-mcp-server/
├── 📄 src/
│ ├── 🎯 index.js # エントリーポイント
│ ├── 🔌 adapters/ # APIアダプター
│ │ └── 📊 e-stat/
│ │ ├── EStatClient.js # e-Stat APIクライアント
│ │ └── config.js # 設定ファイル
│ ├── 🖥️ server/ # MCPサーバー実装
│ │ ├── DataDownloadServer.js
│ │ └── config.js
│ ├── ⚙️ core/ # 基底クラス
│ │ ├── DataSourceClient.js
│ │ └── ToolBase.js
│ └── 🛠️ tools/ # MCPツール
│ ├── index.js
│ ├── e_stat_search.js
│ ├── e_stat_get_data.js
│ ├── e_stat_get_meta.js
│ ├── hello.js
│ └── test_connection.js
├── 🔒 .env.example # 環境変数テンプレート
├── 📦 package.json
├── 📖 README.md
└── 📝 CLAUDE.md🚨 注意事项
- 🆔 APIキー必須: e-Stat API应用程序ID需要
- 📊 数据限制：一个请求最多可获得10000个
- 🚫 汇率限制: API中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积
- 🔒 安全性:
src/config/api-keys.js绝对不要提交（受.gitignore保护）
🆘 故障排除
API键错误
e-Stat API key is not configured→ src/config/api-keys.js检查文件API确认密钥是否正确设置
连接错误
timeout of 30000ms exceeded-网络连接和e-Stat API检查服务状态
📄 许可证
MIT许可证
🤝 分发
Issues、Pull Requests非常欢迎！
______________________________________________________________________
由以下材料制成❤️ 日本政府统计分析