# 補助金アンテナ MCP サーバー

[![npm](https://img.shields.io/npm/v/hojokin-antenna-mcp)](https://www.npmjs.com/package/hojokin-antenna-mcp) [![license](https://img.shields.io/npm/l/hojokin-antenna-mcp)](./LICENSE)

日本の補助金・助成金を AI アシスタントから検索するための MCP サーバーです。
終了した公募のアーカイブと、そこから割り出した「例年の公募時期」を扱えます。

> An MCP server for searching Japanese government subsidies and grants,
> including an archive of closed calls and their recurring application periods.

## できること

- 地域・業種・目的・募集状況での検索
- 締切が近い順の一覧(残り日数つき)
- **終了した公募の検索**。公的サイトからは消えていく情報を残しています
- **例年の公募時期の照会**。「この補助金は次にいつ公募されそうか」に過去の実績で答えます

デジタル庁が公開している公式 MCP サーバー
([digital-go-jp/jgrants-mcp-server](https://github.com/digital-go-jp/jgrants-mcp-server))は
現在募集中の公募を扱います。こちらは終了案件のアーカイブを持っている点が違いです。
用途に応じて併用できます。

## セットアップ

Node.js 18 以上が必要です。

### Claude Code

```bash
claude mcp add hojokin-antenna -- npx -y hojokin-antenna-mcp
```

### Claude Desktop / その他のクライアント

設定ファイルに次を追加します。

```json
{
  "mcpServers": {
    "hojokin-antenna": {
      "command": "npx",
      "args": ["-y", "hojokin-antenna-mcp"]
    }
  }
}
```

## ツール

| ツール | 用途 | 主なパラメータ |
|---|---|---|
| `search_subsidies` | 条件で検索 | `query`, `pref`, `industry`, `purpose`, `status`, `limit` |
| `get_subsidy` | ID指定で1件の詳細 | `id` |
| `list_deadlines` | 締切が近い順 | `within_days`, `pref`, `industry`, `limit` |
| `list_recurring_schedule` | 例年の公募時期 | `month`, `query`, `limit` |

`status` は `open`(既定) / `upcoming` / `closed` / `all` から選べます。
`pref` を指定すると、その都道府県が対象の制度に加えて全国対象の制度も返します。

### 使い方の例

```
「東京都の製造業で使える補助金を締切が近い順に教えて」
「省エネ関連の補助金で、来月までに締め切るものはある?」
「ものづくり補助金は例年いつ公募が始まる?」
「4月に公募が始まる制度をまとめて」
```

## 例年の公募時期について

`list_recurring_schedule` が返すのは**過去の実績の集計**で、次回の公募を予告・保証するものではありません。
制度は年度ごとに改廃され、公募時期が変わることも、公募自体が行われないこともあります。

掲載の基準は次のとおりです。緩めると、すでに廃止された制度や、同じ年度内の複数回の締切を
「毎年の恒例」として見せてしまうためです。

- 異なる年に3回以上の公募実績があること
- 直近の公募開始が2年以内であること
- 各年の最初の公募開始月が、実績のある年の半数以上で一致すること

## データについて

- データ提供元: [補助金アンテナ](https://hojokin-antenna.pages.dev) の公開データ `/data/v1/`
- 一次情報: Jグランツ(デジタル庁)公開API、J-Net21(中小機構)支援情報ヘッドライン
- 更新頻度: 1日1回
- 環境変数 `HOJOKIN_ORIGIN` でデータ取得元を変更できます(既定 `https://hojokin-antenna.pages.dev`)

取得したデータは1時間メモリにキャッシュします。データが日次更新なので、それ以上の頻度で取りに行く意味がないためです。

## 免責

公的機関の公開情報を加工したものです。正確性・最新性は保証されません。
申請の際は必ず各制度の公式ページで最新の公募要領を確認してください。
本サーバーの利用によって生じた損害について、作者は責任を負いません。

補助金の申請書類の作成・添削は行いません(行政書士法により有償の書類作成は独占業務です)。

## 開発

```bash
npm install
npm test        # 実際に MCP クライアントから4つのツールを呼んで確認する
```

ローカルのデータで試す場合:

```bash
HOJOKIN_ORIGIN=http://localhost:8931 npm test
```

## ライセンス

MIT