e-Stat MCP
政府統計の総合窓口(e-Stat)API MCP サーバー。
Features
- 統計表情報の検索(JSON/CSV)
- 統計データの取得・一括取得(JSON/CSV)
- メタ情報の取得(JSON/CSV)
- データセットの登録・参照
- データカタログ情報の取得(JSON/CSV)
- キーワード検索
Data Source
- e-Stat API: https://www.e-stat.go.jp/api/
- API仕様: https://www.e-stat.go.jp/api/api-info/e-stat-manual3-0
Installation
uv tool install git+https://github.com/koizumikento/e-stats-mcp.git
Or install locally:
git clone https://github.com/koizumikento/e-stats-mcp.git
cd e-stats-mcp
uv sync
Configuration
Application ID
e-Stat APIを使用するにはアプリケーションIDが必要です。
- e-Stat API にアクセス
- ユーザー登録・ログイン
- アプリケーションIDを取得
環境変数に設定:
export E_STAT_APP_ID="your-app-id"
MCP Server Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Installed version:
{
"mcpServers": {
"e-stats-mcp": {
"command": "e-stats-mcp",
"env": {
"E_STAT_APP_ID": "your-app-id"
}
}
}
}
Direct from GitHub:
{
"mcpServers": {
"e-stats-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/koizumikento/e-stats-mcp.git",
"e-stats-mcp"
],
"env": {
"E_STAT_APP_ID": "your-app-id"
}
}
}
}
Local development:
{
"mcpServers": {
"e-stats-mcp": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/e-stats-mcp",
"e-stats-mcp"
],
"env": {
"E_STAT_APP_ID": "your-app-id"
}
}
}
}
Cursor
Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"e-stats-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/koizumikento/e-stats-mcp.git",
"e-stats-mcp"
],
"env": {
"E_STAT_APP_ID": "your-app-id"
}
}
}
}
Available Tools
統計表検索
get_stats_list/get_stats_list_csv- 統計表情報を検索search_stats_by_keyword- キーワードで簡単検索
メタ情報取得
get_meta_info/get_meta_info_csv- 統計表のメタ情報を取得
統計データ取得
get_stats_data/get_stats_data_csv- 統計データを取得get_stats_data_bulk- 複数ID/データセットの一括取得
データセット
post_dataset- データセット登録(postDataset)get_dataset- データセット参照(refDataset)
データカタログ
get_data_catalog/get_data_catalog_csv- データカタログ情報を取得
分野コード
get_stats_fields- 統計分野コード一覧(静的マッピング)
Examples
キーワードで統計を検索
Tool: search_stats_by_keyword
Arguments: {"keyword": "人口", "limit": 10}
統計表情報をCSVで取得
Tool: get_stats_list_csv
Arguments: {"search_word": "国勢調査", "survey_years": "2020", "limit": 5}
統計表情報を詳細検索
Tool: get_stats_list
Arguments: {"search_word": "国勢調査", "survey_years": "2020"}
統計データを取得
Tool: get_stats_data
Arguments: {"stats_data_id": "0003411001", "limit": 50}
統計データを一括取得
Tool: get_stats_data_bulk
Arguments: {"stats_data_ids": ["0003411001", "0003411002"], "limit": 100}
メタ情報を取得
Tool: get_meta_info
Arguments: {"stats_data_id": "0003411001"}
データセットを登録
Tool: post_dataset
Arguments: {
"dataset_name": "sample-dataset",
"stats_data_id": "0003411001",
"conditions": {"cdCat01": "000"}
}
データカタログ情報をCSVで取得
Tool: get_data_catalog_csv
Arguments: {"search_word": "人口", "limit": 20}
統計分野コード一覧を取得
Tool: get_stats_fields
Arguments: {}
統計分野コード
| コード | 分野 |
|---|---|
| 01 | 国土・気象 |
| 02 | 人口・世帯 |
| 03 | 労働・賃金 |
| 04 | 農林水産業 |
| 05 | 鉱工業 |
| 06 | 商業・サービス業 |
| 07 | 企業・家計・経済 |
| 08 | 住宅・土地・建設 |
| 09 | エネルギー・水 |
| 10 | 運輸・観光 |
| 11 | 情報通信・科学技術 |
| 12 | 教育・文化・スポーツ・生活 |
| 13 | 行財政 |
| 14 | 司法・安全・環境 |
| 15 | 社会保障・衛生 |
| 16 | 国際 |
| 17 | その他 |
License
MIT
