日本の公的データ（統計・法人・不動産）にAIからアクセスするMCPサーバー。e-Stat統計API・法人番号Web-API・不動産情報ライブラリAPIの3API統合。全国約1,700市区町村対応。
日本の地域分析・比較に特化した MCP（Model Context Protocol）サーバーです。
e-Stat（政府統計の総合窓口）、 国税庁 法人番号公表サイト、 国土交通省 不動産情報ライブラリ、 適格請求書発行事業者公表サイト の API を通じて 日本の公的データにアクセスし、人間が読みやすい形式に自動変換して返します。
13000 → 東京都）を名称に自動変換| ツール名 | 説明 |
|---|---|
search_statistics | キーワードで統計表を検索 |
get_regional_data | 指定地域の統計データを取得（summary=True で最新データのみ） |
compare_regions | 複数地域のデータを比較（ピボットテーブル） |
get_meta_info | 統計表のメタ情報（分類コード体系）を確認 |
resolve_area | 地域名 → 地域コードを検索 |
list_available_stats | 統計分野コードの一覧を表示 |
get_population | 地域の人口データを自動取得（プリセット） |
get_regional_profile | 地域の総合プロファイルを自動取得（プリセット） |
| ツール名 | 説明 |
|---|---|
search_corporations | 法人名で企業を検索（地域・種別で絞り込み可） |
get_corporation | 法人番号から企業の詳細情報を取得 |
| ツール名 | 説明 |
|---|---|
search_invoice_by_name | 会社名からインボイス登録番号を検索（法人のみ） |
check_invoice_registration | 登録番号（T+13桁）でインボイス登録状況を確認 |
validate_invoice_on_date | 指定日時点でのインボイス登録有効性を確認 |
| ツール名 | 説明 |
|---|---|
get_real_estate_transactions | 不動産取引価格情報を取得（価格サマリー付き） |
# 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
対話的セットアップコマンドで簡単に設定できます:
japan-data-mcp setup
画面の案内に従って API キーを入力すると .env ファイルが自動生成されます。
| 環境変数 | API | 必須 | 取得先 |
|---|---|---|---|
ESTAT_APP_ID | e-Stat API | 必須 | e-Stat API ガイド |
CORP_APP_ID | 法人番号 Web-API | 任意 | 法人番号公表サイト（発行まで2〜4週間） |
REALESTATE_API_KEY | 不動産情報ライブラリ API | 任意 | 不動産情報ライブラリ |
CORP_APP_ID はインボイスAPIでも共用されます（追加キー不要）。プロジェクトルートに .env ファイルを作成:
ESTAT_APP_ID=あなたのアプリケーションID
CORP_APP_ID=あなたのアプリケーションID
REALESTATE_API_KEY=あなたのAPIキー
japan-data-mcp
claude_desktop_config.json に以下を追加してください。
{
"mcpServers": {
"japan-data-mcp": {
"command": "uv",
"args": ["run", "japan-data-mcp"],
"env": {
"ESTAT_APP_ID": "あなたのアプリケーションID",
"CORP_APP_ID": "あなたのアプリケーションID（任意）",
"REALESTATE_API_KEY": "あなたのAPIキー（任意）"
}
}
}
}
{
"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
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
uvx japan-data-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-izyuusya-japan-data-mcp": {
"command": "uvx",
"args": [
"japan-data-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referenceio.github.Izyuusya/japan-data-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.