Jグランツ MCP サーバー

デジタル庁の補助金電子申請システム「Jグランツ」の公開APIをラップしたModel Context Protocol (MCP) サーバー。Claude DesktopなどのLLMが自然言語で補助金・助成金情報を検索・取得できるようにします。

🚀 クイックスタート

1. セットアップ

# リポジトリのクローン
git clone https://github.com/42tahara/jgrants-mcp.git
cd jgrants-mcp

# 仮想環境の作成と有効化
python3 -m venv venv
source venv/bin/activate  # macOS/Linux

# 依存関係のインストール
pip install -r requirements.txt

2. Claude Desktopへの設定

設定ファイル: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "jgrants": {
      "command": "/絶対パス/venv/bin/python",
      "args": ["/絶対パス/jgrants_mcp_server.py"]
    }
  }
}

設定例は examples/claude_desktop_config.example.json を参照してください。

3. 動作確認

# MCPサーバーのテスト
python tests/test_mcp_server.py

📚 ドキュメント

詳細なドキュメントは docs/ ディレクトリにあります：

完全版README - セットアップ方法、使い方、全ツール解説
使用例集 - 具体的なクエリパターンと実例
開発者ガイド - アーキテクチャ、API仕様、開発ワークフロー
AI向けガイド - Claude Code向けプロジェクト概要（ルート配置）

🛠️ 主な機能

提供ツール

search_subsidies - 補助金・助成金の検索
- キーワード検索、フィルタリング（業種、地域、従業員数など）
- 募集中のみ表示オプション
get_subsidy_detail - 特定の補助金の詳細情報取得
- 全21フィールドの完全実装
- HTML除去済みの見やすい形式
list_search_options - 検索フィルタオプション一覧
- 利用可能な業種、地域、従業員数区分を表示

📁 プロジェクト構成

jgrants/
├── jgrants_mcp_server.py    # メインのMCPサーバー実装
├── requirements.txt          # 依存パッケージ
├── CLAUDE.md                 # Claude Code向けガイド
├── docs/                     # 詳細ドキュメント
├── tests/                    # テスト・検証スクリプト
└── examples/                 # 設定ファイル例

🔗 関連リンク

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

詳しい情報は docs/README.md をご覧ください。