# hybrid-rag-mcp-server

[hybrid-rag-pdf-jp](../hybrid-rag-pdf-jp) をラップした MCP（Model Context Protocol）サーバーです。
Claude Desktop などの MCP 対応クライアントから、PDF への自然言語検索をツールとして利用できます。

---

## アーキテクチャ

```
Claude Desktop (MCP クライアント)
        │  MCP (stdio)
        ▼
  server.py（FastMCP）
        │  import
        ▼
  hybrid-rag-pdf-jp/rag.py
        │  load_vectorstore()
        ▼
  ChromaDB（ローカル永続化）
        │  類似チャンク検索 (k=4)
        ▼
  nomic-embed-text（Ollama）
```

### 提供ツール

| ツール名 | 引数 | 説明 |
|---|---|---|
| `search_pdf` | `query: str` | PDF 内をベクトル検索し、上位 4 チャンクを返す |
| `get_pdf_info` | なし | ChromaDB の登録チャンク数・ソースファイル情報を返す |

---

## 前提条件

- Python 3.11 以上
- [Ollama](https://ollama.com/) が起動済みで `nomic-embed-text` がインストール済み
- `hybrid-rag-pdf-jp` の `chroma_db/` が構築済み（`python rag.py` を一度実行済み）
- Anthropic API キーを取得済み
- **Node.js** v18以上（MCP Inspector使用時のみ必要）
  https://nodejs.org/en/download から Prebuilt Installer をインストール

```bash
ollama pull nomic-embed-text
```

---

## セットアップ手順

### 1. リポジトリのクローン（または配置確認）

```
project/
├── hybrid-rag-pdf-jp/   ← 既存プロジェクト（chroma_db 構築済み）
└── hybrid-rag-mcp-server/  ← 本プロジェクト
```

### 2. 環境変数の設定

```bash
cp .env.example .env
# .env を編集して ANTHROPIC_API_KEY を設定
```

`.env` の内容:

```env
ANTHROPIC_API_KEY=your_key_here
CHROMA_DB_PATH=../hybrid-rag-pdf-jp/chroma_db
RAG_PROJECT_PATH=../hybrid-rag-pdf-jp
```

### 3. 依存パッケージのインストール

```bash
pip install -e .
```

### 4. 動作確認

```bash
python server.py
```

MCP Inspector を使ったデバッグ:

```bash
mcp dev server.py
```

---

## Claude Desktop への登録方法

`claude_desktop_config.json` に以下を追記します。

**設定ファイルの場所:**
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "hybrid-rag-pdf-jp": {
      "command": "python",
      "args": [
        "C:\\Users\\pcuser\\Documents\\project\\hybrid-rag-mcp-server\\server.py"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your_key_here",
        "CHROMA_DB_PATH": "C:\\Users\\pcuser\\Documents\\project\\hybrid-rag-pdf-jp\\chroma_db",
        "RAG_PROJECT_PATH": "C:\\Users\\pcuser\\Documents\\project\\hybrid-rag-pdf-jp"
      }
    }
  }
}
```

設定後、Claude Desktop を再起動してください。

---

## 使い方

Claude Desktop でツールが有効になると、以下のような自然言語で PDF を検索できます。

```
「FXのリスク管理について教えて」
→ search_pdf("FXのリスク管理") が呼ばれ、PDF の関連箇所を返す

「登録されているPDFの情報を教えて」
→ get_pdf_info() が呼ばれ、チャンク数やファイル名を返す
```

---

## ライセンス

MIT