AI导哈

统计数据下载服务

一个利用日本政府统计综合门户'e-Stat'API的Model Context Protocol (MCP)服务器，提供统计数据的搜索、获取和分析功能。

  • by shimizu
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 shimizu/e-stat-data-download-mcp-server

使用说明

📊 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-template

2.安装相关性

npm install

3. e-Stat API设定🔑

  1. 📝 e-Stat API利用登録创建帐户
  2. 🆔 应用程序ID获得
  3. 🔧 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 dev

Claude 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 （字符串，必填）：統計表ID
  • limit (number, optional): 捕获计数（1-10000，默认值：1000）
  • startPosition (number, optional): 取得开始位置
  • metaGetFlg (string, optional): 元数据检索标志（Y/N）

使用例:

{
  "dataSetId": "0003448237",
  "limit": 500
}

📝 e_stat_get_meta

获取统计表的元数据

参数：

  • dataSetId （字符串，必填）：統計表ID
  • explanationGetFlg (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非常欢迎！

由以下材料制成❤️ 日本政府统计分析

相关 MCP