关于 localgov-jp
localgov-jp 是一个 MCP 服务,让 AI Agent 查询日本中央及市町村的补贴。它涵盖 J-Grants 公共 API 未收录的市町村补贴,并提供补贴比较、引用验证和从业者查询工具。
主要功能
- 01搜索并查看补贴记录
- 02按市町村查找补贴
- 03查找叠加补贴
- 04比较不同市町村的补贴
- 05验证已签名的引用凭证
- 06查找补贴相关从业者
适用场景
- 01为企业或项目查找补贴
- 02选择市町村时比较补贴
- 03离线核验补贴引用凭证
MCP 相关
该服务向 MCP 客户端提供八种工具,用于搜索补贴及详情、查询市町村补贴、比较补贴、订阅变更、验证凭证和推荐从业者。可通过 MCP 客户端配置以 stdio 运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://localgov.jp/mcpclaude mcp add --transport http localgov-jp https://localgov.jp/mcp{"mcpServers":{"localgov-jp":{"type":"http","url":"https://localgov.jp/mcp"}}}在 Cursor 中打开{"servers":{"localgov-jp":{"type":"http","url":"https://localgov.jp/mcp"}}}在 VS Code 中打开{"mcpServers":{"localgov-jp":{"type":"http","url":"https://localgov.jp/mcp"}}}{"mcpServers":{"localgov-jp":{"serverUrl":"https://localgov.jp/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
8| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sort | enum | 否 | 排序方式;设置 keyword 时默认为 "relevance",否则默认为 "newest"。relevance | deadline_asc | amount_desc | newest |
| limit | integer | 否 | 要返回的最大记录数(1-100,默认值为 20) |
| offset | integer | 否 | 分页偏移量(默认 0) |
| keyword | string | 否 | 日语自由文本关键词(FTS),例如 "IT導入"、"創業"、"省エネ"。 |
| category | string | 否 | 类别标签(例如 "子育て"、"住宅"、"事業者支援");通常可省略,改用关键词筛选。 |
| open_only | boolean | 否 | 为 true 时,排除截止日期已过的记录(默认值:false = 包含所有记录) |
| prefecture | string | 否 | 使用汉字填写都道府县名称,例如 "東京都"、"北海道" |
| min_amount_jpy | integer | 否 | JPY 补助金额下限;仅返回 amount_max_jpy >= 此值的记录 |
| municipality_code | string | 否 | JIS X 0402 六位市区町村代码(例如 131105 = 杉並区) |
详细介绍
@localgov-jp/mcp-server
适用于 LocalGov.jp 的模型上下文协议(MCP)服务,涵盖日本中央及市町村补贴,并以适合 AI Agent 使用的结构呈现。
LocalGov.jp 涵盖 1,627 个市町村的 20,000 多项补贴(目标为 1,718 个)。其中,20,810 项市町村补助金未通过 J-Grants 公共 API 提供——这是本服务相较于数字厅官方 J-Grants MCP 的差异所在;后者只提供中央及都道府县级记录。
本服务向 MCP 客户端(Claude Desktop、Cursor、Cline、Windsurf 等)提供 8 个工具。
工具
| # | 工具 | 费用 | 用途 |
|---|---|---|---|
| 1 | search_subsidies | 免费 | 按关键词/都道府县/市町村/类别/金额搜索 |
| 2 | get_subsidy_detail | 免费 | 获取单条记录及引用锚点 |
| 3 | get_municipality_grants | 免费 | 获取一个 JIS 代码对应的全部补贴(覆盖 1,627 个市町村) |
| 4 | find_supplementary_grants | 免费 | 查找叠加于国家级补贴的市町村「追加」补助金 |
| 5 | compare_municipal_subsidies | 免费 | 比较邻近市町村同类别补助金(选址/迁址) |
| 6 | subscribe_changes | $0.20 | 补助金发生变更时推送 webhook(通过 x402 付费;由 Agent 运行时处理付款) |
| 7 | verify_receipt | 免费 | 离线验证引用回执的 Ed25519 签名 |
| 8 | find_practitioner | 免费(推荐) | 为补助金推荐 行政書士/税理士/中小企業診断士/社労士 |
安装
npm install -g @localgov-jp/mcp-server
也可以直接添加到 MCP 客户端配置中(无需全局安装)。
配置 — Claude Desktop
将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS)或 %APPDATA%\Claude\claude_desktop_config.json(Windows):
{
"mcpServers": {
"localgov-jp": {
"command": "npx",
"args": ["-y", "@localgov-jp/mcp-server"]
}
}
}
重启 Claude Desktop。工具检查器中会显示这 8 个工具。
配置 — Cursor / Cline / Windsurf
同样,将一个条目添加到客户端的 MCP 配置中,让它通过标准输入/输出运行 npx -y @localgov-jp/mcp-server。
配置 — 环境变量
| 变量 | 默认值 | 用途 |
|---|---|---|
LOCALGOV_API_BASE | https://localgov.jp | 覆盖 REST API 基础地址(例如,在本地 wrangler dev 中使用 http://127.0.0.1:8787) |
引用
每条返回的记录都包含:
_source— LocalGov.jp 规范 URL(请引用此链接)。source_url— 政府原始页面(也请引用此链接)。
必须注明来源:使用 _source URL,并标注为 「via LocalGov.jp」。许可证:结构化层采用 CC BY 4.0;政府原始内容仍遵循其发布机构的条款。
验证引用回执
付费的 /api/cite/:id 端点会返回 Ed25519 签名快照。使用 verify_receipt 可离线确认 Agent 保存的引用真实有效且未过期:
> verify_receipt(receipt: <the JSON envelope>)
{ "valid": true, "expired": false, "pubkey_match": true }
信任锚发布于 https://localgov.jp/.well-known/citation-pubkey。
与 Jグランツ MCP 的差异
| Jグランツ MCP(デジタル庁公式) | LocalGov.jp MCP(本服务) | |
|---|---|---|
| 覆盖范围 | 中央及都道府县级 | 1,627 个市町村(目标为 1,718 个)及中央 |
| 市町村补贴 | 0 | 20,810 项为本服务独有 |
find_supplementary_grants | ✗ | ✓ |
compare_municipal_subsidies | ✗ | ✓ |
find_practitioner | ✗ | ✓(推荐渠道) |
| 引用回执(Ed25519) | ✗ | ✓ |
| 变更 webhook | ✗ | ✓(x402 付费) |
两者互为补充。我们建议同时连接两个服务,以便 Agent 全面回答「国家 vs 市町村」相关问题。
许可证
MIT。请参阅 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。