Skip to main content
Glama
koizumikento

e-Stat MCP

by koizumikento
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

e-Stat MCP

政府統計の総合窓口（e-Stat）API MCP サーバー。

Features

  • 統計表情報の検索（JSON/CSV）

  • 統計データの取得・一括取得（JSON/CSV）

  • メタ情報の取得（JSON/CSV）

  • データセットの登録・参照

  • データカタログ情報の取得（JSON/CSV）

  • キーワード検索

Related MCP server: mcp-estat-japan

Data Source

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が必要です。

  1. e-Stat API にアクセス

  2. ユーザー登録・ログイン

  3. アプリケーション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"
      }
    }
  }
}

Codex

Add to ~/.codex/config.toml:

Direct from GitHub:

[mcp_servers.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:

[mcp_servers.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 - statsDatasSpec形式で複数ID/データセットを一括取得

データセット

  • post_dataset - データセット登録（postDataset）

  • get_dataset - データセット参照（refDataset）

refDataset はAPI側に一覧取得用の limit / startPosition がないため、 get_dataset でデータセット一覧を取得する場合の limit / start_position はMCP側で適用されます。

データカタログ

  • get_data_catalog / get_data_catalog_csv - データカタログ情報を取得

広いキーワードだけでデータカタログを検索すると、e-Stat API側で非常に多くの候補に一致して 時間がかかることがあります。まず get_stats_list で統計表候補を探し、stats_code などで 絞ってから get_data_catalog を呼ぶのがおすすめです。広すぎる検索や upstream timeout では、 MCPクライアントが自己修正しやすいように MCP_GUIDANCE または structuredContent.error に 次に試すべき呼び出しを含めて返します。 get_data_catalog_csv も広すぎる検索ではCSV文字列だけでなく、csv と MCP_GUIDANCE を含む JSONオブジェクトを返します。

分野コード

  • 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: {
  "requests": [
    {"statsDataId": "0003411001", "limit": "100"},
    {"statsDataId": "0003411002", "limit": "100"}
  ]
}

stats_data_ids / dataset_ids も後方互換用に利用できますが、e-Stat APIには内部で statsDatasSpec JSON文字列として送信されます。limit / startPosition はMCP側で e-Stat APIが受け付ける文字列形式に正規化されます。

メタ情報を取得

Tool: get_meta_info
Arguments: {"stats_data_id": "0003411001"}

データセットを登録

Tool: post_dataset
Arguments: {
  "dataset_name": "sample-dataset",
  "stats_data_id": "0003411001",
  "conditions": {"cdCat01": "000"}
}

postDataset はe-Stat API側の応答がXMLのみのため、このMCPではXMLをdictに変換して返します。 APIの業務エラーは通常データではなくツールエラーとして扱います。

データカタログ情報をCSVで取得

Tool: get_data_catalog_csv
Arguments: {"search_word": "人口", "limit": 20}

e-Stat API 3.0にはデータカタログ取得のCSVエンドポイントがないため、MCP側で JSON版 getDataCatalog の DATA_CATALOG_INF をCSVへ変換して返します。

統計分野コード一覧を取得

Tool: get_stats_fields
Arguments: {}

統計分野コード

コード

分野

01

国土・気象

02

人口・世帯

03

労働・賃金

04

農林水産業

05

鉱工業

06

商業・サービス業

07

企業・家計・経済

08

住宅・土地・建設

09

エネルギー・水

10

運輸・観光

11

情報通信・科学技術

12

教育・文化・スポーツ・生活

13

行財政

14

司法・安全・環境

15

社会保障・衛生

16

国際

17

その他

License

MIT

Install Server
F
license - not found
B
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/koizumikento/e-stats-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server