jgrants-mcp-server

Jグランツ(デジタル庁が運営する国や自治体の補助金電子申請システム)の公開APIを利用した MCP Server FastMCPライブラリを利用して、以下のMCPツールを提供します。

list_subsidies
キーワード（デフォルトは「補助金」）を指定して、応募受付中の補助金一覧を検索・取得します。
get_subsidy_detail
補助金の詳細情報を補助金のIDを用いて取得します。取得時、添付文書の巨大なbase64データは除去し、代わりにダウンロード用URLを付与します。
download_attachment
指定した補助金の添付文書（カテゴリ、インデックス指定）のダウンロード用URLを返します。
※実際のファイルデータ（base64）は返さず、URL経由で直接ダウンロード可能とします。

注意：
すべてのツールで、補助金の識別にはタイトルではなく必ず id 項目を利用してください（例："a0WJ200000CDIUiMAP"）。

特徴

非同期処理：
httpx ライブラリを利用して非同期でJグランツAPIにアクセスします。
MCPツール：
FastMCPを使用して、以下の3つのツールがMCP形式で公開されています。
- list_subsidies(keyword: str = "補助金")
- get_subsidy_detail(subsidy_id: str)
- download_attachment(subsidy_id: str, category: str, index: int)
軽量なレスポンス：
補助金の詳細情報取得時、添付文書のbase64データは除去され、ダウンロード用URLが生成されるため、レスポンスが軽量になります。

必要環境

Python 3.7 以降
httpx
FastMCP
※または、MCPランチャーが提供するライブラリ
（オプション）FastAPI, Uvicorn（ローカルテスト用）

インストール手順

リポジトリのクローン

git clone <your-repository-url>
cd <repository-directory>

仮想環境の作成と依存パッケージのインストール

source venv/bin/activate   # Windowsの場合: venv\Scripts\activate
pip install httpx fastmcp fastapi uvicorn

ツールの使い方

list_subsidies

概要：指定したキーワードで応募受付中の補助金一覧を取得します。デフォルトは「補助金」ですが、任意のキーワードを入力可能です。
入力パラメータ：
- keyword (文字列, オプション) – 検索キーワード
出力例： JSON形式の文字列（補助金一覧の全体情報）を返します。

get_subsidy_detail

概要：補助金の詳細情報を取得します。添付文書のbase64データは除去され、各添付文書に対して補助金のIDを利用したダウンロードURLが付与されます。
入力パラメータ：
subsidy_id (文字列)
補助金のID（タイトルではなく必ずIDを指定）
出力例： MCP形式のJSONオブジェクト

  "content": [
    {
      "type": "text",
      "text": "<詳細情報のJSON文字列>"
    }
  ]
}

download_attachment

概要：指定した補助金の添付文書について、base64データは返さず、ダウンロード用URLを返します。
入力パラメータ：
- subsidy_id (文字列) – 補助金のID（必ずIDを指定）
- category (文字列) – 添付文書のカテゴリ（例：application_guidelines, outline_of_grant, application_form）
- index (整数) – 添付文書のインデックス（0から開始）

出力例： MCP形式のJSONオブジェクト

  "content": [
    {
      "type": "text",
      "text": "Attachment download URL: https://your-mcp-server.example.com/subsidies/<subsidy_id>/<category>/<index>"
    }
  ]
}