MCP Docs Reader

🚀 mcp-docs-reader 日本語翻訳版

このプロジェクトは、軽量なMCP（モデルコンテキストプロトコル）サーバーです。ローカルフォルダからPDFファイルを読み込み、その内容を抽出してブロックに分割、意味検索インデックスを構築し、関連する段落をClaude Desktopに送信して、ドキュメントベースの質問応答を行います。

このプロジェクトは、ClaudeのMCPデスクトップ機能と一緒に使用することを目的としています。

✨ 主な機能

• ローカルの docs/ フォルダからPDFドキュメントを読み込み、処理する
• テキストを抽出し、意味ブロックに分割する
• SentenceTransformerを使用して文の埋め込みを生成する
• FAISSベースのベクトルインデックスを構築して意味検索を行う
• ユーザーのクエリに基づいて、上位k個の関連ブロックを検索する
• プロンプト（関連段落 + 質問）を構築し、Claudeに返す
• uv を使用して最小限の設定で動作する

🚀 クイックスタート

1. Claude Desktopをインストールする（未インストールの場合）

• Claude Desktop をダウンロードし、指示に従ってインストールします。

2. mcp-docs-reader をダウンロードする

オプション1：ZIPファイルとしてダウンロードする

• “コード” > “ZIPでダウンロード” をクリックします。
• ダウンロードしたZIPファイルを解凍します。

オプション2：Gitを使用してリポジトリをクローンする

git clone https://github.com/AIMIZING/mcp_docs_reader.git
cd mcp_docs_reader

3. UV環境を設定する

オプション1：手動で設定する

• uvをインストールする（未インストールの場合）：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• 仮想環境を作成し、アクティブ化する：

uv venv
.venv\Scripts\activate

• 依存関係をインストールする：

pip install -r requirements.txt

オプション2：自動で設定する（Windows）

• 同梱されている “setup.bat” ファイルを実行します。

4. Claude Desktopを設定する

同梱されている “weather_config.json” ファイルを開き、その内容をコピーします。 次に、既存のClaude Desktopの設定ファイルを開き、コピーした内容を適切な位置に追加します。

Claude Desktopの設定ファイルの場所を見つける方法：

• Claude Desktopを開きます。
• メニュー → ファイル → 設定 → 開発者モード → 設定を編集 を選択します。
• 現在の “claude_desktop_config.json” ファイルが開きます。
• 適切な位置（例えば、mcpリストまたは関連する部分）にコピーした内容を貼り付けます。

⚠️ 重要提示

貼り付ける前に、docReader_config.json内のパス "C:\PATH\TO\mcp_docs_reader" を実際のローカルプロジェクトのパスに置き換えてください。

⚠️ 重要提示

ファイル全体を上書きしないでください。既存の設定を破壊しないように、追加またはマージを行ってください。

5. Claude Desktopを起動する

Claude Desktopを起動します。起動すると、自動的に設定されたMCPツールを検出し、接続します。 これで、ローカルのPDFドキュメントに基づいてClaudeに質問することができます。例えば：

“登録ファイルの内容の要点をまとめてください。”