Jgrants MCP Server

🚀 jgrants-mcp-server

J grants（由日本數字廳運營的國家或地方政府補助金電子申請系統）公開 API 使用的 MCP 服務器。本項目利用 FastMCP 庫提供以下 MCP 工具，幫助用戶更便捷地獲取補助金相關信息。

🚀 快速開始

本項目旨在為用戶提供便捷的方式來訪問 J grants 公開 API，獲取補助金的相關信息。通過幾個簡單的步驟，你就可以開始使用這些工具。

✨ 主要特性

• 非同步處理：使用 httpx 庫實現異步訪問 J grants API，提高響應速度和效率。
• MCP 工具：FastMCP 提供以下三個工具，以 MCP 格式公開：
  • list_subsidies(keyword: str = "補助金")：指定關鍵詞（默認為“補助金”），搜索並獲取正在接受申請的補助金一覽表。
  • get_subsidy_detail(subsidy_id: str)：使用補助金 ID 獲取詳細信息。獲取時，去除龐大的 base64 數據，轉而提供下載用 URL。
  • download_attachment(subsidy_id: str, category: str, index: int)：指定補助金的附件（類別、索引指定），返回下載用 URL。
• 輕量響應：去除不必要的數據，提供簡潔的響應，減少數據傳輸量。

📦 安裝指南

環境要求

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

⚠️ 重要提示

所有工具中，請使用 ID 而不是標題來識別補助金（例如："a0WJ200000CDIUiMAP"）。