mcp-docs-reader

mcp-docs-reader

ローカルフォルダーから PDF ファイルを読み込み、その内容を抽出してチャンクに分割し、セマンティック検索インデックスを構築して、関連する文章を Claude Desktop に送信し、ドキュメントに基づく質問応答を行う軽量な MCP（Model Context Protocol）サーバーです。

このプロジェクトは、Claude の MCP デスクトップ機能と併用することを想定しています。

---

機能

• ローカルの docs/ フォルダーから PDF ドキュメントを読み込み、処理します
• テキストを抽出し、セマンティックチャンクに分割します
• SentenceTransformer を使ってベクトル埋め込みを生成します
• セマンティック検索用に FAISS ベースのベクトルインデックスを構築します
• ユーザーのクエリに基づいて、関連性の高い上位 k 個のチャンクを取得します
• プロンプト（関連する文章＋質問）を作成し、Claude に返します
• uv を使って最小限のセットアップで利用できます

---

使い方

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

• Claude Desktop をダウンロードしてインストールします。

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

方法 1：ZIP としてダウンロード

• 「Code」 > **「Download 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 を開きます
• メニューから「File」→「Settings」→「Developer Mode」→「Edit Configuration」の順に選択します
• 現在の 「claude_desktop_config.json」 ファイルが開きます
• 適切な位置（例：mcp リスト内または関連するセクション内）に追加の内容を貼り付けます

⚠️ コピーする前に、docReader_config.json 内のパス "C:\PATH\TO\mcp_docs_reader" を実際のローカルプロジェクトのパス（例：C:\Users\YourName\Documents\mcp_docs_reader）に置き換えてください。

⚠️ ファイル全体を上書きしないでください。既存の設定を壊さないよう、内容を追記または統合してください。

5. Claude Desktop を起動する

Claude Desktop を起動します。 起動すると、設定済みの MCP ツールが自動的に検出され、接続されます。 これで、次のようにローカルの PDF ドキュメントに基づいて Claude に質問できるようになります。

「登録済みファイルの内容から、重要なポイントを要約してください。」