What is Estatmcp

eStatMCP is a Model Context Protocol (MCP) server designed to facilitate the interaction between generative AI and the e-Stat API, which is a comprehensive portal for government statistics in Japan.

Use cases

Use cases include integrating e-Stat data into AI-driven applications, generating reports based on statistical data, and providing insights for decision-making processes.

How to use

To use eStatMCP, obtain an application ID from the e-Stat user registration. Then, configure the server settings in either Claude Desktop or Docker, specifying the application ID and response size for data retrieval.

Key features

Key features include functions to retrieve statistical table information, survey names, metadata, and statistical data, all simplified into a JSON format for easier handling by generative AI.

Where to use

eStatMCP can be used in various fields such as data analysis, research, and application development where government statistical data is required.

README in English is here

e-Stat MCP Server

政府統計の総合窓口(e-Stat)のAPI機能を生成AIが扱えるようにするMCPサーバです。

MCPとは

Model Context Protocol (MCP)は、アプリケーションが何を提供してくれるかを生成AIに教えるための様式です。Anthropicが2024年11月に提唱し、標準になりつつあります。生成AIからのリクエストを待つサーバとして実装したものを、MCPサーバと呼びます。既存のサービスを生成AIが扱えるようにするMCPサーバが数多く作られています。

Tools

• get_tables

  • 統計表情報取得(URL: getStatsList)を行います。

• get_surveys

  • 統計表情報取得(URL: getStatsList)の中の統計調査名一覧取得を行います。

• get_metadata

  • メタ情報取得(URL: getMetaInfo)を行います。
  • 必須パラメータ
    • 統計表ID（statsDataId）

• get_data

  • 統計データ取得(URL: getStatsData)を行います。
  • 必須パラメータ
    • 統計表ID（statsDataId）

それぞれの関数ではe-StatのAPIレスポンスを簡略化したJSON形式に変換して返すように実装しています。

使用方法

e-Stat用アプリケーションIDの取得

利用ガイドに従ってe-Statのユーザ登録を行い、アプリケーションIDを取得してください。

Claude Desktopの設定

Claude Desktopを使う場合は、claude_desktop_config.jsonに次の記述を加えてください。claude_desktop_config.jsonはMacの場合は~/Library/Application\ Support/Claude/、Windowsの場合は%AppData%\Claude\にあります。

ビルドしたjarファイルがある場合

{
  "mcpServers": {
    "eStatMCP": {
      "command": "java",
      "args": [
        "-jar",
        "build/libs/<your-jar-name>.jar"
      ],
      "env": {
        "ESTAT_API_KEY": "<アプリケーションID>",
        "RESPONSE_SIZE": "100"
      }
    }
  }
}

Dockerを使う場合

{
  "mcpServers": {
    "eStatMCP": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESTAT_API_KEY",
        "-e",
        "RESPONSE_SIZE",
        "ichiro21/estat-mcp"
      ],
      "env": {
        "ESTAT_API_KEY": "<アプリケーションID>",
        "RESPONSE_SIZE": "100"
      }
    }
  }
}

<アプリケーションID>には、ご自身のe-StatのアプリケーションIDを入れてください。

RESPONSE_SIZEには、e-Stat APIから1度に受信するデータ数を指定します。AIチャットのコンテキスト長を制限したい場合に使用します。e-Stat API側のデフォルトは100,000です。

VS Codeの設定

VS Codeを使う場合は、settings.jsonに次の記述を加えてください。settings.jsonはVS CodeでCtrl + Shift + Pを押すと出てくるメニューからPreferences: Open User Settings (JSON)を選ぶと開くことができます。

Dockerを使う場合

{
  "mcp": {
    "servers": {
      "eStatMCP": {
        "type": "stdio",
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "ESTAT_API_KEY",
          "-e",
          "RESPONSE_SIZE",
          "ichiro21/estat-mcp"
        ],
        "env": {
          "ESTAT_API_KEY": "${env:ESTAT_API_KEY}",
          "RESPONSE_SIZE": "100"
        }
      }
    }
  }
}

VS Codeでは設定の中でOSの環境変数を${env:ESTAT_API_KEY}のように呼び出すことができます。OSの環境変数を使わない場合は直接記述するか、VS Codeに記憶させることができます。（こちらの記入例を参照）

サーバプログラムのビルド

このMCPサーバをビルドするにはJava 17かそれ以降のバージョンとGradleが必要です。次のコマンドでjarファイルを作成します。

./gradlew clean build -x test

使用例

経済に関する統計調査を取得

https://claude.ai/share/ac66bee7-1178-4f8a-977c-cdd6629c0f21

調べたい調査名か決まっていないときは統計表を検索する前に統計調査を検索することができます。

人口に関する統計を取得

https://claude.ai/share/5f6874e2-4fc6-42e5-a8dd-6e8feb6158df

人口推計の最新のデータを取得してくれました。

東京都の家計調査の結果を取得（途中まで）

https://claude.ai/share/d393e0cc-50ec-4770-9ae0-600740bb275d

家計調査の結果表のメタデータが大きすぎてClaudeのコンテキスト長を超えてしまいました。

人口推計から年齢5歳階級別人口を取得

https://claude.ai/share/e33bbc27-6094-4feb-984f-5c2cf6d5e5a2

統計調査名、項目名まで指示したら的確に取得してくれました。人口推計の「参考表」を取得させないために、「統計表」で検索するように指定しています。