Jgrants MCP Server

🚀 jgrants-mcp-server

J grants（日本のデジタル庁が運営する国や地方自治体の補助金の電子申請システム）の公開APIで使用されるMCPサーバーです。FastMCPライブラリを利用して、以下のMCPツールを提供します。

• list_subsidies
  指定したキーワード（デフォルトは「補助金」）で、申請受付中の補助金一覧を検索して取得します。

• get_subsidy_detail
  補助金IDを使用して詳細情報を取得します。取得時には、膨大なbase64データを削除し、代わりにダウンロード用のURLを提供します。

• download_attachment
  補助金の添付ファイルを指定（カテゴリ、インデックス指定）し、ダウンロード用のURLを返します。
  ※実際のファイルデータ（base64）は直接返さず、URLから直接ダウンロードできます。

⚠️ 重要提示

すべてのツールで、補助金を識別するにはタイトルではなくID（例："a0WJ200000CDIUiMAP"）を使用してください。

✨ 主な機能

• 非同期処理：
  httpxライブラリを使用して、J grants APIへの非同期アクセスを実現します。

• MCPツール：
  FastMCPは以下の3つのツールを提供し、MCP形式で公開します。

  • list_subsidies(keyword: str = "補助金")
  • get_subsidy_detail(subsidy_id: str)
  • download_attachment(subsidy_id: str, category: str, index: int)

• 軽量なレスポンス：
  不要なデータを削除し、シンプルなレスポンスを提供します。

📦 インストール

環境要件

• Python 3.6以上
• 必要なライブラリ：
  • httpx
  • fastmcp
  • fastapi
  • uvicorn

インストール手順

1. リポジトリをクローンします。

   git clone <your-repository-url>
   

2. 環境依存ライブラリをインストールします。

   pip install httpx fastmcp fastapi uvicorn
   

💻 使用例

list_subsidies

入力パラメータ

• keyword (文字列、オプション) – 検索キーワード、デフォルトは「補助金」。

出力例

{
    "subsidies": [
        {
            "id": "a0WJ200000CDIUiMAP",
            "name": "补助金项目1",
            "description": "该项目的描述。",
            "amount": "100000"
        },
        ...
    ]
}

get_subsidy_detail

入力パラメータ

• subsidy_id (文字列) – 補助金ID。

出力例

{
    "id": "a0WJ200000CDIUiMAP",
    "name": "补助金项目1",
    "description": "该项目的描述。",
    "amount": "100000",
    "details": {
        "eligibility": "符合条件的条件。",
        "application_deadline": "申请截止日期。",
        "contact_information": "联系方式。"
    }
}

download_attachment

入力パラメータ

• subsidy_id (文字列) – 補助金ID。
• category (文字列) – 添付ファイルのカテゴリ（例：application_guidelines, outline_of_grant, application_form）。
• index (整数) – 添付ファイルのインデックス（0から始まる）。

出力例

{
    "url": "https://your-mcp-server.example.com/subsidies/<subsidy_id>/<category>/<index>"
}