tatsuyamiyazaki/jgrants-mcp-server

Jグランツ MCP Server (Node.js版)

デジタル庁が運用する補助金電子申請システム「Jグランツ」の公開APIをModel Context Protocol（MCP）サーバーとして実装。 LLMから自然言語で補助金検索・詳細取得が可能です。

参考実装: https://github.com/digital-go-jp/jgrants-mcp-server (Python版)

特徴

• リモート対応: stdio経由でMCPクライアントと通信
• 高度な検索機能: キーワード、業種、従業員数、地域での絞り込み
• 統計分析: 補助金の統計情報を自動集計（締切期間別、金額規模別）
• ファイルダウンロード: 募集要項や申請書類の自動ダウンロード・保存
• 添付資料アクセス: PDFなどの添付資料をMarkdown/BASE64形式で取得可能
• LLM統合: 自然言語での補助金検索と詳細取得
• ファイル変換: PDF、Word、Excel、ZIPなど多様な形式をMarkdownに変換
• TypeScript: 型安全性とコード品質を保証

動作確認環境

• Claude Desktop: v0.7.10以上
• Node.js: 18以上
• @modelcontextprotocol/sdk: 1.0.4以上

クイックスタート

前提条件

• Node.js 18以上
• npm (Node.jsパッケージマネージャー)

環境セットアップ

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

# 依存パッケージのインストールとビルド
npm install

# または手動でビルド
npm run build

環境変数（オプション）

必要に応じて以下の環境変数を設定できます：

設定例：

export JGRANTS_FILES_DIR=/tmp/jgrants_files

または.envファイルを作成：

JGRANTS_FILES_DIR=./jgrants_files

Claude Desktop との連携

Claude Desktop は stdio 接続をサポートしているため、直接MCPサーバーと通信できます。

Claude Desktop 設定

1. Claude Desktop 設定ファイルを編集:

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

   {
     "mcpServers": {
       "jgrants": {
         "command": "node",
         "args": [
           "/path/to/jgrants-mcp-server/dist/index.js"
         ]
       }
     }
   }
   

   または、グローバルインストールした場合：

   {
     "mcpServers": {
       "jgrants": {
         "command": "jgrants-mcp-server"
       }
     }
   }
   

2. Claude Desktop を再起動

接続確認

Claude Desktopを開き、新しい会話で以下のように質問してみてください：

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

サーバーが正しく設定されていれば、利用可能なツールの一覧が表示されます。

Prompts と Resources

MCPサーバーは、LLMが効果的にツールを使用できるよう、プロンプトとリソースを提供します。

Prompts（動的ガイド）

• subsidy_search_guide: 補助金検索のベストプラクティスと推奨検索パターン
• api_usage_agreement: API利用規約と免責事項の確認

Resources（静的リファレンス）

• jgrants://guidelines: MCPサーバー利用ガイドライン、API制限、トラブルシューティング

利用可能なツール

1. search_subsidies

補助金を検索します。キーワード、業種、地域、従業員数などで絞り込み可能。

パラメータ:

• keyword (string): 検索キーワード（2文字以上必須）
• industry (string, optional): 業種
• target_area_search (string, optional): 対象地域
• target_number_of_employees (string, optional): 従業員数制約
• sort (string): ソート順（acceptance_end_datetime / acceptance_start_datetime / created_date）
• order (string): 昇順/降順（ASC / DESC）
• acceptance (number): 受付状態（0: 全て / 1: 受付中のみ）

2. get_subsidy_detail

補助金の詳細情報を取得し、添付ファイルをローカルに保存します。

パラメータ:

• subsidy_id (string): 補助金ID（18文字以下）

返却情報:

• 補助金の詳細情報（タイトル、補助上限額、補助率、受付期間など）
• 添付ファイル情報（公募要領、概要資料、申請様式など）
• ファイル保存先ディレクトリのパス

3. get_subsidy_overview

補助金の統計情報を取得します（締切期間別、金額規模別の集計）。

パラメータ:

• output_format (string): 出力形式（json / csv）

4. get_file_content

保存済みの添付ファイルの内容を取得します。

パラメータ:

• subsidy_id (string): 補助金ID
• filename (string): ファイル名
• return_format (string): 返却形式（markdown / base64）

機能:

• PDF、Word、Excel、PowerPoint、ZIPをMarkdownに自動変換
• 変換失敗時はBASE64形式で返却

5. ping

サーバーの疎通確認を行います。

開発とテスト

テスト実行

# 開発モードで起動（TypeScriptを直接実行）
npm run dev

# テスト実行
node tests/test_core.js

デバッグ

# TypeScriptのまま実行（開発時）
npm run dev

プロジェクト構造

jgrants-mcp-server/
├── src/
│   └── index.ts          # メインMCPサーバー実装
├── dist/                 # ビルド済みJavaScript
├── tests/
│   └── test_core.js      # 統合テスト
├── tmp/                  # 添付ファイル保存先（デフォルト）
├── package.json
├── tsconfig.json
└── README.md

ライセンス

MIT License - 詳細はファイルを参照してください。

免責事項

本実装は、技術検証を目的としたサンプルコードです。以下の点にご留意ください：

• 本コードは現状のまま提供され、動作の安定性や継続的な保守を保証するものではありません
• Jグランツサービスの検索性や動作の安定性を保証するものではありません
• 実際の利用にあたっては、JグランツAPIの利用規約 (https://www.jgrants-portal.go.jp/open-api) に準じてご利用ください