Skip to main content
Glama
n-irei

hybrid-rag-mcp-server

by n-irei

hybrid-rag-mcp-server

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 の登録チャンク数・ソースファイル情報を返す


Related MCP server: Claude RAG MCP Pipeline

前提条件

  • Python 3.11 以上

  • Ollama が起動済みで nomic-embed-text がインストール済み

  • hybrid-rag-pdf-jpchroma_db/ が構築済み(python rag.py を一度実行済み)

  • Anthropic API キーを取得済み

  • Node.js v18以上(MCP Inspector使用時のみ必要) https://nodejs.org/en/download から Prebuilt Installer をインストール

ollama pull nomic-embed-text

セットアップ手順

1. リポジトリのクローン(または配置確認)

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

2. 環境変数の設定

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

.env の内容:

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

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

pip install -e .

4. 動作確認

python server.py

MCP Inspector を使ったデバッグ:

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

{
  "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

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    D
    maintenance
    Enables AI assistants to search and query PDF documents through a local RAG system with vector embeddings. Provides semantic document search capabilities while keeping all data stored locally without external dependencies.
  • F
    license
    -
    quality
    D
    maintenance
    Transforms PDF collections into a searchable knowledge base using TF-IDF indexing and proximity matching. It enables users to search documents, retrieve specific page content, and manage document libraries through natural language via MCP clients.
    5
  • A
    license
    A
    quality
    C
    maintenance
    Enables MCP clients to list indexed PDF document collections and perform semantic search queries on them using locally extracted text and embeddings.
    2
    AGPL 3.0

View all related MCP servers

Related MCP Connectors

  • Generate PDFs from templates via AI chat. Works with Claude, ChatGPT, Cursor, and any MCP client.

  • Apple Developer Documentation with Semantic Search, RAG, and AI reranking for MCP clients

  • Agentic search over your Dewey document collections from any MCP-compatible client.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/n-irei/hybrid-rag-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server