Japan Data MCP

japan-data-mcp

npm：@mameta/japan-data-mcp · MCP Registry：io.github.Mameta29/japan-data-mcp · 传输方式：stdio

一个 MCP 服务，让 AI Agent（Claude Desktop、Cursor、Cline 等）通过一次调用 访问 agentic-jp.com 提供的一系列日本数据 API。每次调用都通过 x402 支付协议按次结算——无需账户、订阅或 API 密钥。

涵盖范围——7 个 API，共 28 种工具

API	工具	功能
address	address_normalize、address_geocode、address_reverse_geocode、address_postal_code、address_parse	日本地址规范化、地理编码、邮政编码查询及自由格式解析
furigana	furigana_convert、furigana_name_readings、furigana_classify	读音转换、姓名读音及文本分类
transit	transit_station_status、transit_line_disruptions、transit_route_plan、transit_alternative_routes、transit_lines、transit_stations_search	实时铁路延误及考虑延误的路线规划（ODPT）
diet	diet_member、diet_members_search、diet_minutes_search	国会议员查询及议事录全文搜索
holiday	holiday_is_holiday、holiday_list、holiday_add_business_days、holiday_business_days_between	公共假日及工作日计算
weather	weather_forecast、weather_warnings、weather_areas	JMA 天气预报和预警
houjin	houjin_corporation、houjin_search、houjin_verify、houjin_kyb_report	法人番号登记系统——578 万家法人，一次调用即可生成 KYB 报告

支付方式

x402 是一种买方付费协议。此 MCP 服务使用你的钱包，并透明地支付每次 API 调用费用——Agent 不会看到支付提示。每次调用的费用约为 $0.001–$0.10（大多低于 1 美分），使用 Base 上的 USDC 结算。

• 使用少量 USDC 为钱包充值。
• 将 EVM_PRIVATE_KEY 设置为该钱包的密钥。
• 服务会按需支付；大多数工具的单次调用费用远低于 1 美分。

如果未设置 EVM_PRIVATE_KEY，服务仍会启动并列出所有工具，但调用付费工具时会返回清晰的“未配置支付”提示，不会收取任何费用。

安全提示： EVM_PRIVATE_KEY 中的密钥可以支用该钱包中的资金。请使用专用钱包，并只存入你打算花费的金额——切勿使用主钱包。

设置

无需安装——npx 会按需获取并运行服务。

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "japan-data": {
      "command": "npx",
      "args": ["-y", "@mameta/japan-data-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_FUNDED_WALLET_KEY"
      }
    }
  }
}

如果未设置 EVM_PRIVATE_KEY，服务仍会启动并列出全部 28 种工具； 但付费工具会返回明确的“支付已禁用”错误，而不会执行。添加注入 USDC 的钱包密钥即可启用这些工具。

Cursor / Cline

将 MCP 客户端指向 npx -y @mameta/japan-data-mcp，并设置相同的 EVM_PRIVATE_KEY 环境变量。传输方式为 stdio。

从源代码运行

git clone https://github.com/Mameta29/japan-data-mcp.git
cd japan-data-mcp
npm install && npm run build
# then point the MCP client at: node /abs/path/to/dist/index.js

提示词示例

连接后，只需用自然语言向 Agent 提问：

• “「東京都千代田区丸の内1-1」を正規化して緯度経度も出して”——address_normalize + address_geocode
• “日本明天是公共假日吗？如果是，下一个工作日是哪天？”——holiday_is_holiday + holiday_add_business_days
• “山手线现在晚点了吗？从涩谷到东京站有哪些替代路线？”——transit_line_disruptions + transit_alternative_routes
• “查询法人番号为 7010401056220 的公司”——houjin_corporation
• “查询国会在哪个委员会、何时讨论过‘数字厅’”——diet_minutes_search

配置

环境变量	必填	说明
EVM_PRIVATE_KEY	使用付费工具时必填	已充值 USDC 的钱包私钥（Base / Polygon）。若未设置，则禁用付费工具。

开发

npm run dev        # run from source with tsx
npm run typecheck  # tsc --noEmit
npm run build      # compile to dist/

许可证

Apache-2.0