使用说明

J格兰兹MCP Server (Gradio 5 Native)

数字厅运用的补助金电子申请系统“J格兰兹“的公开API的集成应用程序。

🚀 Gradio 5本地MCP使用功能：

🌐 Web用户界面：从浏览器直观地搜索补贴
🤖 MCP服务器: Claude Desktop等的LLM使用自然语言
⚡ 单指令启动: launch(mcp_server=True)双方同时动作！

特徴

🎯 Gradio 5母语者MCP整合

简单设计: launch(mcp_server=True)仅仅UI和MCP服务器同时启动
自动变换: Gradio函数自动MCP转换为工具
统一代码库: UI和MCP API管理单一代码

🔍 検索・分析机能

高级搜索：关键字、行业、员工数量和区域限制
统计分析：补助金の统计情报を自动集计（缔切期间别、金额规模别）
实时信息: J发布API中描述的相应参数的值

📄 文件处理

自动下载：募集要项や申请书类を自动保存
形式变换: PDF、Word、Excel、ZIP等多种形式Markdown转换为
BASE64対応：无法转换的文件BASE64格式

🤖 LLM统合

Claude Desktop対応: MCP直接从客户机获得
自然言语検索: LLM用自然语言检索补助金
工具自动检测: Gradio函数自动MCP作为工具发布

🌐 Web应用

直感的UI：通过浏览器轻松访问
制表符接口：按功能排列的选项卡，如搜索、详细信息、统计信息和文件检索
表格显示：以便于查看的表格格式显示搜索结果
Markdown対応：已整形详细信息Markdown显示

动作确认环境

Claude桌面版：v0.7.10以上
python: 3.11以上
FastMCP: 2.12.2以上

快速启动

前提条件

方法1：uv 使用（推荐）

紫外线（高速Python包管理器）
Python 3.11以上（可自动安装uv）

方法2：Docker Compose 使用

方法3：pip 使用（传统）

Python 3.11以上
pip (Python包管理器）

🚀 30秒启动

方法1：uv 使用（推荐・最快）

# 1. リポジトリをクローン
git clone https://github.com/Sunwood-ai-labs/jgrants-gradio-mcp-server.git
cd jgrants-gradio-mcp-server

# 2. uvで依存関係を同期（初回のみ）
uv sync

# 3. 起動（Gradio UI + MCPサーバーが同時に動作）
uv run python -m jgrants_mcp_server

方法2：Docker Compose 使用

# 1. リポジトリをクローン
git clone https://github.com/Sunwood-ai-labs/jgrants-gradio-mcp-server.git
cd jgrants-gradio-mcp-server

# 2. Docker Composeで起動（MCPサーバーが自動的に有効になります）
docker-compose up -d

# ログ確認
docker-compose logs -f

# 停止
docker-compose down

Docker环境功能：

🌐 Web用户界面: http://localhost:7860
🤖 MCP服务器：默认情况下启用（Gradio5本地）
💾 数据持久化：下载文件为Docker volume 保存到

方法3：pip 使用（传统）

# 1. リポジトリをクローン
git clone https://github.com/Sunwood-ai-labs/jgrants-gradio-mcp-server.git
cd jgrants-gradio-mcp-server

# 2. Python仮想環境の作成
python -m venv venv

# 3. 仮想環境の有効化
# macOS/Linux:
source venv/bin/activate
# Windows:
# venv\Scripts\activate

# 4. 依存パッケージをインストール
pip install -r requirements.txt

# 5. 起動（Gradio UI + MCPサーバーが同時に動作）
python -m jgrants_mcp_server

访问方法：

🌐 Web用户界面在浏览器中 http://localhost:7860 的双曲正切值
🤖 主控程序: Claude Desktop从 http://localhost:7860 连接

Gradio 5本地MCP功能可在单个服务器上提供两种功能！

uv安装

uv快速可靠Python包管理器。

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# pipx経由（すべてのプラットフォーム）
pipx install uv

了解更多信息 uv文档来修改标记元素的显示属性。

环境变量（可选）

您可以根据需要设置以下环境变量：

｜环境变量｜默认值｜说明｜ |---------|------------|------| | JGRANTS_FILES_DIR | ./jgrants_files ｜附件保存目录｜ | API_BASE_URL | https://api.jgrants-portal.go.jp/exp/v1/public | J格兰兹API端点｜

设定例：

export JGRANTS_FILES_DIR=/tmp/jgrants_files

服务器启动

🚀 基本起动（Web UI + MCP统合）

uv使用：

# デフォルト起動（ポート7860）
uv run python -m jgrants_mcp_server

# カスタムポート指定
uv run python -m jgrants_mcp_server --port 8080

# 公開リンク生成（外部アクセス可能）
uv run python -m jgrants_mcp_server --share

Docker Compose使用：

# バックグラウンドで起動
docker-compose up -d

# フォアグラウンドで起動（ログを表示）
docker-compose up

# 停止
docker-compose down

# 再起動
docker-compose restart

pip使用：

# デフォルト起動（ポート7860）
python -m jgrants_mcp_server

# カスタムポート指定
python -m jgrants_mcp_server --port 8080

# 公開リンク生成（外部アクセス可能）
python -m jgrants_mcp_server --share

启动后可用功能：

🌐 Web用户界面: http://localhost:7860
🤖 MCP服务器: Gradio提供，提供MCP端点（从Claude Desktop连接）

📋 启动选项

python -m jgrants_mcp_server --help

｜选项｜默认值｜说明｜ |-----------|------------|------| | --host | 0.0.0.0 服务器主机 | --port | 7860 服务器端口 | --share | False | Gradio生成公共链接 | --no-mcp | False | MCP禁用功能（仅限Web UI）

🔧 MCP禁用（仅限Web UI）

# MCPサーバー機能を無効にしてWeb UIのみ起動
python -m jgrants_mcp_server --no-mcp
# uvの場合
uv run python -m jgrants_mcp_server --no-mcp

🐳 Docker自定义环境变量

docker-compose.yml的，之environment您可以编辑节以自定义环境变量：

environment:
  - JGRANTS_FILES_DIR=/app/jgrants_files
  - API_BASE_URL=https://api.jgrants-portal.go.jp/exp/v1/public
  # カスタム設定を追加

🔧 Docker的MCP禁用服务器

MCP禁用服务器Web UI单击功能区上Dockerfile请将最后一行更改为：

# Dockerfileの最終行を変更
CMD ["python", "-m", "jgrants_mcp_server", "--host", "0.0.0.0", "--port", "7860", "--no-mcp"]

然后重新构建并启动容器：

docker-compose up -d --build

Claude Desktop 协作

Gradio 5母语者MCP连接

Gradio 5.32.0单击功能区上Gradio应用程序直接MCP作为服务器工作。

步骤1:启动应用程序

python -m jgrants_mcp_server

在启动消息中MCP Server: ENABLED进行动态观察时的轴心点。

第2步：Claude Desktop设置

Claude Desktop编辑配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jgrants": {
      "command": "uvx",
      "args": [
        "gradio",
        "client",
        "http://localhost:7860"
      ]
    }
  }
}

注意:

Gradio 5的，之MCP服务器是HTTP它在底座上运行
uvx缺少支持的问题pip install uv安装
端口号应与启动时指定的端口匹配

第3步：Claude Desktop重新启动

保存设置，然后单击Claude Desktop之后由应用程序进行调用。

接続确认

Claude Desktop在新的对话中，请按以下方式提问：

補助金を検索できますか？

如果服务器设置正确，将显示可用工具列表。

Gradio Web应用程序的使用方法

起动方法

# デュアルモード（MCPとGradioの両方）
python -m jgrants_mcp_server

# Gradioのみ
python -m jgrants_mcp_server --mode gradio

启动后，在浏览器中 http://localhost:7860 中所述修改相应参数的值。

功能选项卡

🔍 补助金検索

输入搜索条件
- 关键字（必需）：例如IT导入DX设备投资
- 行业、地区、员工人数等限制条件（可选）
- 并び顺：受付终了日时、受付开始日时、作成日时
- 受理状态：仅受理中/全部
検索実行
- 最多显示50个结果
- 各行补助金ID、显示标题、受理期间、辅助上限额等

📄 补助金详细

补助金ID的双曲正切值（搜索结果的ID复制并粘贴）
单击“获取详细信息”按钮
显示的信息
- 补贴详细说明
- 受付期间、补助上限额
- 对象条件（地域、业种、従业员数、利用目的）
- 下载的文件一览表（申请指南、补助金概要、申请文件）

📊 统计情报

选择输出格式（JSON 或CSV）
单击“获取统计信息”按钮
显示的统计信息
- 締切期間別の分布（今月、来月、再来月以降）
- 金额规模别の分布（100万圆以下、1000万圆以下、1亿圆以下、1亿圆超）
- 紧急缔切案件（14日以内）
- 高额补助金（5000万圆以上）

📁 文件检索

补助金ID和文件名
选择格式（Markdown 或BASE64）
单击“文件获取”按钮
显示文件内容
- PDF、Word、Excel、ZIP等等Markdown自动转换为
- 如果无法转换BASE64以格式显示
已下载文件列表
- 检查所有下载的文件

ℹ️ 服务器信息

Ping按钮确认服务器的运行状况
API显示端点、版本信息等

使用例

IT查找辅助部署
- 关键字： IT導入
- 业种： 情報通信業
- 受付状態: 受付中のみ
- 执行搜索-在表格中查看结果
查看详细信息
- 在意的补助金的ID复制
- 转到“补贴详细信息”标签
- ID粘贴以获取详细信息
- 下载文件
确认文件内容
- 转到“文件检索”标签
- 补助金ID和文件名
- Markdown以格式显示内容

生成公共链接

可以生成外部可访问的公共链接：

python -m jgrants_mcp_server --mode gradio --gradio-share

启动时Gradio生成的发布URL中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

Prompts 和Resources

MCP服务器LLM中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

Prompts（动态指南）

subsidy_search_guide：补贴搜索最佳实践和建议的搜索模式
api_usage_agreement: API确认使用条款和免责事项

Resources（静态参考）

jgrants://guidelines: MCP服务器使用指南API限制，故障排除

可用工具

1. `search_subsidies`

查找补贴。可以通过关键字、行业、地区、员工数等进行缩小。

参数：

keyword (str): 搜索关键字（2个以上必需）
industry (str, optional): 业种
target_area_search (str, optional): 対象地域
target_number_of_employees (str, optional): 従业员数制约
sort (str): 排序顺序（acceptance_end_datetime / acceptance_start_datetime / created_date）
order (str): 升顺/降顺（ASC / DESC）
acceptance (int): 受付状態（0：全部/ 1：仅在受理中）

2. `get_subsidy_detail`

获取补贴的详细信息，并在本地保存附件。

参数：

subsidy_id (str): 补助金ID（18文字以下）

返却情报：

补助金的详细信息（标题、补助上限额、补助率、受理期间等）
单击功能区上file:// URL（公开征集要领、概要资料、申请格式等）
文件目标目录路径

3. `get_subsidy_overview`

获取补贴的统计信息（按到期日、金额规模统计）。

参数：

output_format （str）：出力形式（json / csv）

4. `get_file_content`

获取已保存附件的内容。

参数：

subsidy_id (str): 补助金ID
filename (str): 文件名
return_format (str): 返却形式（markdown / base64）

机能：

PDF、Word、Excel、PowerPoint、ZIPをMarkdownに自动变换
转换失败时BASE64形式返还

5. `ping`

进行服务器的沟通确认。

开发和测试

测试运行

# テスト実行
pytest tests/test_core.py

调试

# デバッグモードで起動
python -m jgrants_mcp_server.core --log-level DEBUG

许可证

MIT License - 了解更多信息许可证请参见文件。

免责事项

本实施是以技术验证为目的的样本代码。请注意：

本代码按原样提供，不保证动作的稳定性和持续维护
J它不保证格兰兹服务的可搜索性和行为稳定性
在实际使用时J格兰兹API使用条款https://www.jgrants-portal.go.jp/open-api）为准使用

使用说明

J格兰兹MCP Server (Gradio 5 Native)

特徴

🎯 Gradio 5母语者MCP整合

🔍 検索・分析机能

📄 文件处理

🤖 LLM统合

🌐 Web应用

动作确认环境

快速启动

前提条件

🚀 30秒启动

方法1：uv 使用（推荐・最快）

方法2：Docker Compose 使用

方法3：pip 使用（传统）

uv安装

环境变量（可选）

服务器启动

🚀 基本起动（Web UI + MCP统合）

📋 启动选项

🔧 MCP禁用（仅限Web UI）

🐳 Docker自定义环境变量

🔧 Docker的MCP禁用服务器

Claude Desktop 协作

Gradio 5母语者MCP连接

步骤1:启动应用程序

第2步：Claude Desktop设置

第3步：Claude Desktop重新启动

接続确认

Gradio Web应用程序的使用方法

起动方法

功能选项卡

🔍 补助金検索

📄 补助金详细

📊 统计情报

📁 文件检索

ℹ️ 服务器信息

使用例

生成公共链接

Prompts 和Resources

Prompts（动态指南）

Resources（静态参考）

可用工具

1. search_subsidies

2. get_subsidy_detail

3. get_subsidy_overview

4. get_file_content

5. ping

开发和测试

测试运行

调试

许可证

免责事项

相关 MCP

nostrdb模型上下文协议服务器

Jenkins MCP服务器

补助金搜索服务器

LLM模型协议桥接器

Ghost CMS管理服务器

笑话服务器

1. `search_subsidies`

2. `get_subsidy_detail`

3. `get_subsidy_overview`

4. `get_file_content`

5. `ping`