# Jグランツ MCP サーバー

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

## 🚀 クイックスタート

### 1. セットアップ

```bash
# リポジトリのクローン
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)

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

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

### 3. 動作確認

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

## 📚 ドキュメント

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

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

## 🛠️ 主な機能

### 提供ツール

1. **`search_subsidies`** - 補助金・助成金の検索
   - キーワード検索、フィルタリング（業種、地域、従業員数など）
   - 募集中のみ表示オプション

2. **`get_subsidy_detail`** - 特定の補助金の詳細情報取得
   - 全21フィールドの完全実装
   - HTML除去済みの見やすい形式

3. **`list_search_options`** - 検索フィルタオプション一覧
   - 利用可能な業種、地域、従業員数区分を表示

## 📁 プロジェクト構成

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

## 🔗 関連リンク

- [デジタル庁の実装記事](https://digital-gov.note.jp/n/n09dfb9fa4e8e)
- [Jグランツ公式サイト](https://www.jgrants-portal.go.jp/)
- [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)

## 📄 ライセンス

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

---

**詳しい情報は [docs/README.md](docs/README.md) をご覧ください。**