japan-data-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@japan-data-mcp 札幌市と仙台市の人口を比較して"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
japan-data-mcp
日本の地域分析・比較に特化した MCP(Model Context Protocol)サーバーです。
e-Stat(政府統計の総合窓口)、 国税庁 法人番号公表サイト、 国土交通省 不動産情報ライブラリ、 適格請求書発行事業者公表サイト の API を通じて 日本の公的データにアクセスし、人間が読みやすい形式に自動変換して返します。
特徴
コード自動変換 — e-Stat が返すコード番号(
13000→東京都)を名称に自動変換全国市区町村対応 — 47 都道府県 + 20 政令指定都市 + 全国約 1,700 市区町村に対応
地域比較 — 複数地域のデータをピボットテーブルで並べて比較
プリセット分析 — 統計表 ID を知らなくても、地域名だけで人口データや地域プロファイルを取得
法人検索 — 法人名から企業の法人番号・所在地・種別を検索
インボイス確認 — 会社名からインボイス登録番号を検索、登録状況・有効性を確認
不動産取引価格 — 地域の不動産取引データと価格サマリーを取得
データ検証 — 全ての出力にデータ出典・検証リンク・取得日時を付与
Related MCP server: MCP Statistics Server
提供ツール一覧
統計データ(e-Stat API)
ツール名 | 説明 |
| キーワードで統計表を検索 |
| 指定地域の統計データを取得( |
| 複数地域のデータを比較(ピボットテーブル) |
| 統計表のメタ情報(分類コード体系)を確認 |
| 地域名 → 地域コードを検索 |
| 統計分野コードの一覧を表示 |
| 地域の人口データを自動取得(プリセット) |
| 地域の総合プロファイルを自動取得(プリセット) |
法人情報(法人番号 Web-API)
ツール名 | 説明 |
| 法人名で企業を検索(地域・種別で絞り込み可) |
| 法人番号から企業の詳細情報を取得 |
インボイス(適格請求書発行事業者公表 Web-API)
ツール名 | 説明 |
| 会社名からインボイス登録番号を検索(法人のみ) |
| 登録番号(T+13桁)でインボイス登録状況を確認 |
| 指定日時点でのインボイス登録有効性を確認 |
不動産取引(不動産情報ライブラリ API)
ツール名 | 説明 |
| 不動産取引価格情報を取得(価格サマリー付き) |
セットアップ
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 sync2. APIキー設定
対話的セットアップコマンドで簡単に設定できます:
japan-data-mcp setup画面の案内に従って API キーを入力すると .env ファイルが自動生成されます。
必要なAPIキー
環境変数 | API | 必須 | 取得先 |
| e-Stat API | 必須 | |
| 法人番号 Web-API | 任意 | 法人番号公表サイト(発行まで2〜4週間) |
| 不動産情報ライブラリ 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-mcpClaude 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 を利用しています:
e-Stat(政府統計の総合窓口) — 統計データは CC BY 4.0 で提供
国税庁 法人番号公表サイト Web-API — 法人番号・法人情報
国税庁 適格請求書発行事業者公表サイト Web-API — インボイス登録情報
国土交通省 不動産情報ライブラリ — 不動産取引価格情報
このサービスは各 API 提供元のデータを利用していますが、サービスの内容は各機関によって保証されたものではありません。
ライセンス
MIT License
Available Tools
14 toolscheck_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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
Japan data tools for AI agents: calendar (rokuyo), address, name splitting, corporate number lookup
Verify Japanese companies, invoice-issuer registrations and addresses against government open data.
Raw Japanese regulatory data for AI agents: pension, gazette, gBizINFO. x402-metered (USDC).
Search Japanese company credit, financials, subsidies, and procurement via AI agents.
Related MCP Servers
- AlicenseCqualityBmaintenanceEnables 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.13MIT
- AlicenseNot gradedqualityDmaintenanceProvides LLMs access to Japanese and international statistical data (e-Stat, World Bank, OECD, Eurostat) with tools for data retrieval, chart generation, and statistical analysis.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query Japanese public data (laws, corporations, statistics) from official government APIs, returning normalized English metadata with source attribution.1MIT
- AlicenseAqualityBmaintenanceEnables 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.9283 npmApache 2.0