Japan Data MCP

日本数据mcp

是专门用于日本的地域分析·比较的MCP（Model Context Protocol）服务器。

e-Stat（政府统计の総合窗口）、 网站页面信息、 国土交通省房地产信息库、 网站页面信息 的API 访问日本的公共数据，自动转换为人类容易读的形式返回。

解说记事: 打100次e-Stat API就知道了，政府数据是宝物的腐败事件

特徴

• 代码自动转换 —e-Stat返回的代码编号（13000 → 東京都）自动转换为名称
• 全国市区町村対応 — 47 都道府県 + 20 政令指定都市 + 全国約 1,700 市区町村に対応
• 地域比较 -将多个地区的数据与透视表进行比较
• 预置分析 —即使不知道统计表ID，也可以仅凭地区名称获取人口数据和地区概况
• 法人検索 —从法人名中检索企业的法人编号、所在地、类别
• 发票确认 —根据公司名称查找发票登记号，确认登记情况和有效性
• 不动产取引似格 —获取地区房地产交易数据和价格汇总
• 数据验证 —为所有输出提供数据来源、验证链接、获取日期和时间

提供工具列表

统计数据（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密钥

• 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("東京都")

汇总获取人口、经济、劳动等多个领域的数据，作为一个报告返回。

开発

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

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

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

出典

此项目使用以下API：

• e-Stat（政府统计の総合窗口） —统计数据显示 CC 4.0 提供
• 网站页面信息查询 — 法人番号・法人情報
• 国税厅合格发票发行经营者公布网站Web-API —发票登记信息
• 国土交通省房地产信息库 —不动产取引似格情报

此服务使用每个API提供者的数据，但服务内容不是由每个机构保证的。

许可证

MIT许可证