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