内容
-mcp
[](https://www.npmjs.com/package/@mameta/japan-data-mcp)
[](https://www.apache.org/licenses/LICENSE-2.0)
> npm: [`@mameta/japan-data-mcp`](https://www.npmjs.com/package/@mameta/japan-data-mcp) · MCP Registry: `io.github.Mameta29/japan-data-m · transport: **stdio**
MCP 服务器**,为 AI 代理(Claude Desktop, Cline, …)提供了一次调用访问 [agentic-jp.com](https://agentic-jp.com) 套件中的日本数据 API 的功能。每一次调用都通过 **x402** 支付协议 — 无需账户,无需订阅,无需 API 密钥。
## 功能覆盖 — 7 个 API 中的 工具
| API | 功能描述 |
|---|---|---|
| **地址** | `address`, `address_geocode`, `address_reverse_geocode`, `address_code`, `address_parse` | 日本地址标准化、地理编码、邮政编码查找、自由格式解析 |
| **读音** | `furigana_convert`, `furigana_name_readings`, `furig | 读取转换、名称读音、文本分类 |
| **交通** |it_station_status`, `transit_line_disruptionstransit_route_plan`, `transit_alternative_routes`, `transit_lines`, `transit_stations_search` | 实时铁路延误 + 延误感知路线规划(ODPT) |
| **国会** | `diet_member`, `diet_members_search`, `diet_minutes_search`, `diet_minutes_summarize`, `diet_topic_track`, `diet_bill_votes` | 国会成员、会议记录、AI 摘要、投票 |
| **节假日** | `holiday_is_holiday`, `holiday_list`, `holiday_add_business_days`, `holiday_business_days_between` | 公众假期 + 工作日计算 |
| **天气** | `weather_forecast`, `weather_warnings`, `weather_areas` | 日本气象厅预报和警告 |
| ** | `houjin_cor`, `houjin_search`, `houjin_verify` | 法人编号(法人番号)注册 — 578 万家企业 |
##
x402 是一种 **买家支付** 协议。该 MCP **您的** 钱包,并透明地支付每次 API 调用 — 代理永远不会看到支付提示。约为 **0.001–10 美元**(大多为一分钱以下),在 Base 上使用 USDC 结算。
- 您用少量 USDC 资助一个- 您将 `EVM_PRIVATE_KEY` 设置为该钱包。
- 服务器边用边大多数工具的每次调用远低于一美分。
如果没有 `EVM_PRIVATE_KEY`,服务器仍然会启动并列出所有 30 种工具,但付费工具调用会返回一条清晰的“未配置支付”消息 — 不会产生任何费用。
> **安全性:** `EVM_PRIVATE_KEY` 中的密钥可以花费该钱包的资金。请使用一个专门的钱包,并仅用您打算花费的金额充值 — 永远不要使用主钱包。
## 设置
无需安装步骤 — `npx` 按需获取并运行服务器。
### Claude Desktop
添加到 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"japan-data": {
"command": "npx",
"args": ["-y", "@a/japan-data-mcp"],
"env": {
"EVM_PRIVATE_KEY": "0x您的已充值钱包密钥"
}
}
}
}
```
如果没有 `EVM_PRIVATE_KEY`,服务器仍然会启动并列出所有 30 种工具;付费工具随后会返回一条清晰的“支付已禁用”错误消息,而不是运行。添加一个 USDC 充值的钱包密钥即可启用它们。
/ Cline
将 MCP 客户端指向 `npx -y @mameta/japan-data-mcp`,并使用相同的 `EVM_PRIVATE_KEY` 环境变量。传输方式为 stdio。
### 从源码编译
```bash
git://github.com/Mameta29/japan-data-mcpcd japan-data-mcp
npm run build
# 然后将 MCP 客户端指向:abs/path/to/dist/index```
## 示例提示
连接后用自然语言询问代理- "「東京都千区丸の内1-1」を正規化して緯度経度も出して"address_normalize` + `address_geocode`
- "Is holiday in Japan?, when is the next business `holiday_is_holiday` + `holiday_add_business_days`
- "山手線いま遅れてる?渋谷から東京駅までの代替ルートは?" — `transit_line_disruptions` + `trans_routes`
- "Look up the corporation with corporate number 7010401056220" — `houjin_corporation`
- "国会で「デジタル庁」について最近議論された内容をして" — `diet_minutes_search` + `diet_minutes_summarize`
## 配置
| 环境变量 | 是否必需 | 描述 |
|---|---|---|
| `EVM_PRIVATE_KEY` | 付费工具必需 | USDC 充值的钱包(Base /