Skip to main content
Glama
japan-data-mcp
by Izyuusya

japan-data-mcp

日本の地域分析・比較に特化した MCP(Model Context Protocol)サーバーです。

e-Stat(政府統計の総合窓口)、 国税庁 法人番号公表サイト、 国土交通省 不動産情報ライブラリ、 適格請求書発行事業者公表サイト の API を通じて 日本の公的データにアクセスし、人間が読みやすい形式に自動変換して返します。

解説記事: e-Stat APIを100回叩いてわかった、政府データが宝の持ち腐れな件|DATA POPCORN

特徴

  • コード自動変換 — e-Stat が返すコード番号(13000 → 東京都)を名称に自動変換

  • 全国市区町村対応 — 47 都道府県 + 20 政令指定都市 + 全国約 1,700 市区町村に対応

  • 地域比較 — 複数地域のデータをピボットテーブルで並べて比較

  • プリセット分析 — 統計表 ID を知らなくても、地域名だけで人口データや地域プロファイルを取得

  • 法人検索 — 法人名から企業の法人番号・所在地・種別を検索

  • インボイス確認 — 会社名からインボイス登録番号を検索、登録状況・有効性を確認

  • 不動産取引価格 — 地域の不動産取引データと価格サマリーを取得

  • データ検証 — 全ての出力にデータ出典・検証リンク・取得日時を付与

Related MCP server: MCP Statistics Server

提供ツール一覧

統計データ(e-Stat API)

ツール名

説明

search_statistics

キーワードで統計表を検索

get_regional_data

指定地域の統計データを取得(summary=True で最新データのみ)

compare_regions

複数地域のデータを比較(ピボットテーブル)

get_meta_info

統計表のメタ情報(分類コード体系)を確認

resolve_area

地域名 → 地域コードを検索

list_available_stats

統計分野コードの一覧を表示

get_population

地域の人口データを自動取得(プリセット)

get_regional_profile

地域の総合プロファイルを自動取得(プリセット)

法人情報(法人番号 Web-API)

ツール名

説明

search_corporations

法人名で企業を検索(地域・種別で絞り込み可)

get_corporation

法人番号から企業の詳細情報を取得

インボイス(適格請求書発行事業者公表 Web-API)

ツール名

説明

search_invoice_by_name

会社名からインボイス登録番号を検索(法人のみ)

check_invoice_registration

登録番号(T+13桁)でインボイス登録状況を確認

validate_invoice_on_date

指定日時点でのインボイス登録有効性を確認

不動産取引(不動産情報ライブラリ API)

ツール名

説明

get_real_estate_transactions

不動産取引価格情報を取得(価格サマリー付き)

セットアップ

1. インストール

# uv(推奨)
uv add japan-data-mcp

# pip
pip install japan-data-mcp

# ソースから
git clone https://github.com/Izyuusya/japan-data-mcp.git
cd japan-data-mcp
uv sync

2. APIキー設定

対話的セットアップコマンドで簡単に設定できます:

japan-data-mcp setup

画面の案内に従って API キーを入力すると .env ファイルが自動生成されます。

必要なAPIキー

環境変数

API

必須

取得先

ESTAT_APP_ID

e-Stat API

必須

e-Stat API ガイド

CORP_APP_ID

法人番号 Web-API

任意

法人番号公表サイト(発行まで2〜4週間)

REALESTATE_API_KEY

不動産情報ライブラリ API

任意

不動産情報ライブラリ

  • e-Stat API は必須 です。未設定の場合サーバーが起動しません。

  • 法人番号・不動産 API は任意です。未設定でも他の機能は正常に動作します。

  • CORP_APP_ID はインボイスAPIでも共用されます(追加キー不要)。

  • 全て 無料 で取得できます。

手動設定する場合

プロジェクトルートに .env ファイルを作成:

ESTAT_APP_ID=あなたのアプリケーションID
CORP_APP_ID=あなたのアプリケーションID
REALESTATE_API_KEY=あなたのAPIキー

3. サーバー起動

japan-data-mcp

Claude Desktop での設定

claude_desktop_config.json に以下を追加してください。

uv でインストールした場合

{
  "mcpServers": {
    "japan-data-mcp": {
      "command": "uv",
      "args": ["run", "japan-data-mcp"],
      "env": {
        "ESTAT_APP_ID": "あなたのアプリケーションID",
        "CORP_APP_ID": "あなたのアプリケーションID(任意)",
        "REALESTATE_API_KEY": "あなたのAPIキー(任意)"
      }
    }
  }
}

pip でインストールした場合

{
  "mcpServers": {
    "japan-data-mcp": {
      "command": "japan-data-mcp",
      "env": {
        "ESTAT_APP_ID": "あなたのアプリケーションID",
        "CORP_APP_ID": "あなたのアプリケーションID(任意)",
        "REALESTATE_API_KEY": "あなたのAPIキー(任意)"
      }
    }
  }
}

ヒント: .env ファイルに設定済みの場合は env セクションを省略できます。

使用例

地域の人口データを取得する

get_population("札幌市")

複数地域を比較する

compare_regions(
    stats_data_id="0003433219",
    areas=["札幌市", "仙台市", "福岡市"]
)

法人を検索する

search_corporations("トヨタ", area="愛知県")

インボイス登録を確認する

search_invoice_by_name("トヨタ自動車", area="愛知県")

不動産取引価格を調べる

get_real_estate_transactions("札幌市", year=2023)

地域の総合プロファイルを取得する

get_regional_profile("東京都")

人口・経済・労働など複数分野のデータをまとめて取得し、1 つのレポートとして返します。

開発

# 依存関係のインストール
uv sync

# テスト実行
uv run python -m pytest tests/ -v

# サーバーの直接起動
uv run japan-data-mcp

出典

このプロジェクトは以下の API を利用しています:

このサービスは各 API 提供元のデータを利用していますが、サービスの内容は各機関によって保証されたものではありません。

ライセンス

MIT License

Available Tools

14 tools
check_invoice_registrationA

適格請求書発行事業者の登録情報を登録番号で確認する.

インボイス制度に基づく適格請求書発行事業者の登録状況・ 名称・所在地などを確認できる。

Args: number: 登録番号(T+13桁の数字、例: "T1234567890123")。 カンマ区切りで最大10件まで同時に検索可能。 history: 変更履歴を含めるか(デフォルト: False)

Returns: 登録事業者の情報(マークダウン)

Inputs: number (required), history. Returns: result

compare_regionsA

複数地域の統計データを比較する.

時間軸(年)を行、地域を列にしたピボットテーブルを生成。

Args: stats_data_id: 統計表ID(search_statistics で取得) areas: 比較する地域名のリスト(例: ["東京都", "大阪府", "愛知県"]) tab_code: 表章項目コード(特定の指標に絞り込む場合) cat01_code: 分類事項01コード(特定のカテゴリに絞り込む場合)

Returns: 地域比較のピボットテーブル(マークダウン)

Inputs: areas (required), stats_data_id (required), tab_code, cat01_code. Returns: result

get_corporationA

法人番号から企業の詳細情報を取得する.

13桁の法人番号を指定して、法人の正式名称・所在地・種別などを取得。

Args: corp_number: 法人番号(13桁の数字)

Returns: 法人の詳細情報(マークダウン)

Inputs: corp_number (required). Returns: result

get_meta_infoA

統計表のメタ情報(分類コード体系)を取得する.

統計表にどのような次元(地域・時間・カテゴリ等)があるか、 各次元にどのようなコードが定義されているかを確認できる。 データ取得前の下調べに便利。

Args: stats_data_id: 統計表ID(search_statistics で取得)

Returns: 分類オブジェクトの一覧(各次元のコード→名称マッピング)

Inputs: stats_data_id (required). Returns: result

get_populationA

地域の人口データを自動取得する(プリセット).

統計表IDを知らなくても、地域名を指定するだけで 人口推計や国勢調査から人口推移データを取得できる。

Args: area: 地域名(例: "東京都")または地域コード(例: "13000")

Returns: 人口推移の整形済みレポート(マークダウン)

Inputs: area (required). Returns: result

get_real_estate_transactionsA

不動産取引価格情報を取得する.

国土交通省の不動産情報ライブラリから、指定地域の不動産取引データを取得。 取引種別・価格・面積・建築年・最寄駅などの情報を含む。

Args: area: 地域名(例: "東京都", "水戸市")または地域コード year: 取引年で絞り込み(例: 2023) quarter: 四半期で絞り込み(1〜4)

Returns: 不動産取引データの一覧と価格サマリー(マークダウン)

Inputs: area (required), year, quarter. Returns: result

get_regional_dataA

指定した地域の統計データを取得し、整形して返す.

コード番号は自動的に人間が読める名称に変換される。

Args: stats_data_id: 統計表ID(search_statistics で取得) area: 地域名(例: "東京都")または地域コード(例: "13000") tab_code: 表章項目コード(特定の指標に絞り込む場合) time_code: 時間軸コード(特定の年に絞り込む場合) cat01_code: 分類事項01コード(特定のカテゴリに絞り込む場合) limit: 取得件数上限(デフォルト1000) summary: Trueの場合、最新時点の主要指標のみ返す(データ量を大幅に削減)

Returns: 整形済みの統計データ(マークダウンテーブル)

Inputs: area (required), stats_data_id (required), limit, summary, +3 more. Returns: result

get_regional_profileB

地域の総合プロファイルを自動取得する(プリセット).

人口・経済・労働など複数分野の統計データを自動検索・取得し、 1つのレポートにまとめる。地域の概要を素早く把握したいときに便利。

Args: area: 地域名(例: "東京都")または地域コード(例: "13000")

Returns: 地域の総合プロファイル(マークダウン)

Inputs: area (required). Returns: result

list_available_statsA

利用可能な統計分野の一覧を表示する.

search_statistics の stats_field パラメータに使えるコードの一覧。

Returns: 統計分野コードと名称の一覧

Inputs: no named parameters. Returns: result

resolve_areaA

地域名から e-Stat の地域コードを検索する.

都道府県名の部分一致で検索可能。 「東京」→「東京都 (13000)」のように接尾辞なしでもマッチする。

Args: name: 地域名(例: "東京", "大阪府", "北海")

Returns: マッチした地域名と地域コードの一覧

Inputs: name (required). Returns: result

search_corporationsA

法人名で企業を検索する.

国税庁の法人番号公表サイトから法人情報を検索。 地域や法人種別で絞り込み可能。

Args: name: 検索キーワード(法人名、部分一致) area: 地域名で絞り込み(都道府県名、例: "東京都") kind: 法人種別で絞り込み("01"=国の機関, "02"=地方公共団体, "03"=設立登記法人, "04"=その他) limit: 取得件数上限(デフォルト10、最大2000)

Returns: 法人情報の一覧(マークダウンテーブル)

Inputs: name (required), area, kind, limit. Returns: result

search_invoice_by_nameA

会社名からインボイス登録番号を検索する.

法人番号APIで会社名を検索し、該当法人のインボイス登録状況を 自動で確認する。法人番号 → 登録番号(T+法人番号)の変換を 内部で行うため、登録番号を知らなくても検索できる。

※ 個人事業主は法人番号を持たないため、このツールでは検索できません。 個人事業主の場合は登録番号(T+13桁)を直接指定して check_invoice_registration をご利用ください。

Args: name: 検索キーワード(会社名、部分一致) area: 地域名で絞り込み(都道府県名、例: "東京都") limit: 取得件数上限(デフォルト5、最大10)

Returns: インボイス登録情報の一覧(マークダウン)

Inputs: name (required), area, limit. Returns: result

search_statisticsA

キーワードで統計表を検索する.

Args: keyword: 検索キーワード(例: "人口", "国勢調査", "県内総生産") survey_years: 調査年で絞り込み(例: "2020", "2015-2020") stats_field: 統計分野コードで絞り込み(例: "02"=人口・世帯)。 list_available_stats で分野一覧を確認できます。 limit: 取得件数上限(デフォルト10)

Returns: 検索結果の統計表一覧(ID・統計名・タイトルなど)

Inputs: keyword (required), limit, stats_field, survey_years. Returns: result

validate_invoice_on_dateA

指定日時点での適格請求書発行事業者の登録有効性を確認する.

特定の取引日に事業者がインボイス発行資格を持っていたかを確認できる。

Args: number: 登録番号(T+13桁の数字、例: "T1234567890123") day: 確認日(YYYY-MM-DD形式、例: "2024-12-01")

Returns: 指定日時点の登録状態(マークダウン)

Inputs: day (required), number (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, and the descriptions help separate similar actions. A few pairs could be confused—search_corporations vs. search_invoice_by_name, and check_invoice_registration vs. validate_invoice_on_date—but their intent is still discernible.

    Naming Consistency4/5

    The tools almost all follow a snake_case verb_noun pattern, which is predictable and readable. Minor deviations like validate_invoice_on_date and search_invoice_by_name add prepositional modifiers, and check/validate are near-synonyms, so the consistency is not perfect.

    Tool Count5/5

    14 tools is well within a reasonable scope for a multi-domain Japan data server covering statistics, corporate records, real estate, and invoice registration. Each tool serves a distinct purpose, including presets that add convenience without bloating the set.

    Completeness4/5

    The server covers core end-to-end workflows: search/retrieve statistics, resolve codes, get metadata, compare regions, look up companies, fetch real estate transactions, and verify invoice registrations. Minor gaps exist, such as limited real-estate filtering and no area-only corporate browsing, but agents can work around them.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      Enables access to Japan's official government statistics portal (e-Stat) API to search, retrieve, and analyze statistical data including census data, economic indicators, and demographic information across 17 statistical fields.
      13
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to query Japanese public data (laws, corporations, statistics) from official government APIs, returning normalized English metadata with source attribution.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to look up Japanese statutes and articles as of a chosen date, compare old and new versions, full-text search law bodies, and search National Diet session records. It also verifies whether legal citations in a document actually exist and traces which provisions cite or are cited by a given article.
      9
      283 npm
      Apache 2.0