What is Jgrants Mcp Server

jgrants-mcp-server is an MCP Server that utilizes the public API of J Grants, a digital application system for subsidies managed by the Digital Agency of Japan.

Use cases

Use cases include searching for available subsidies, retrieving detailed information about specific subsidies, and downloading related documents through provided URLs.

How to use

To use jgrants-mcp-server, clone the repository, create a virtual environment, and install the required dependencies. You can then access the MCP tools provided, such as list_subsidies, get_subsidy_detail, and download_attachment.

Key features

Key features include asynchronous processing using the httpx library, lightweight responses by generating download URLs instead of returning large base64 data, and three main MCP tools for managing subsidies.

Where to use

jgrants-mcp-server can be used in government agencies, non-profit organizations, and any entities involved in subsidy management and application processes.

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（ローカルテスト用）

インストール手順

1. リポジトリのクローン

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

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

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>"
      }
    ]
  }