🤖 Claude AI Documentation Assistant 📚

🤖 Claude AI ドキュメントアシスタント 📚

✨ 主な機能

• 🔍 スマートなドキュメント検索 - 複数の AI／ML ライブラリのドキュメントを横断して検索します
• 🧠 Claude との連携 - Claude の高度な推論機能とシームレスに接続します
• 🌐 インテリジェントなウェブ検索 - Serper API を活用し、対象を絞ったドキュメント検索を行います
• 💨 高速な応答 - 素早い取得と処理に最適化されています
• 🧩 拡張可能なアーキテクチャ - ドキュメントソースを簡単に追加できます

📋 前提条件

• 🐍 Python 3.8 以降
• 🔑 Claude Pro サブスクリプション
• 🔐 Serper API キー（こちらから取得）
• 💻 Claude デスクトップアプリケーション

🚀 クイックスタート

1️⃣ インストール

# Clone the repository
git clone https://github.com/your-username/claude-docs-assistant.git
cd claude-docs-assistant

# Create a virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

2️⃣ 設定

プロジェクトのルートに API キーを含む .env ファイルを作成します。

SERPER_API_KEY=your_serper_api_key_here

3️⃣ MCP サーバーを起動する

python main.py

サーバーが実行中で、Claude からの接続を待っていることを示す出力が表示されます。

4️⃣ Claude デスクトップアプリを接続する

1. 📱 Claude デスクトップアプリを開きます
2. ⚙️ プロフィールアイコンをクリックし、「Settings」を選択します
3. 🧰 「Tools」セクションに移動します
4. ➕ 「Add Tool」をクリックします
5. 🔗 「Connect to a local tool」を選択します
6. 🖥️ 画面の指示に従って、実行中の MCP サーバーに接続します
7. ✅ 接続が成功したことを確認します

🎮 Claude ドキュメントアシスタントを使う

接続したら、ドキュメント検索が実行されるよう Claude に質問できます。たとえば、次のように質問します。

Could you explain how to use FAISS with LangChain? Please search the langchain documentation to help me.

Claude は MCP サーバーを自動的に使用して、次の処理を行います。

1. 🔍 関連するドキュメントを検索します
2. 📥 内容を取得します
3. 🧠 情報を処理して説明します

🔧 内部の仕組み

📄 コード構成

claude-docs-assistant/
├── main.py           # MCP server implementation
├── requirements.txt  # Project dependencies
├── .env              # Environment variables (API keys)
└── README.md         # This documentation

🔌 対応ライブラリ

このアシスタントは現在、次のドキュメント検索に対応しています。

• 🦜 LangChain: python.langchain.com/docs
• 🦙 LlamaIndex: docs.llamaindex.ai/en/stable
• 🧠 OpenAI: platform.openai.com/docs

🧩 仕組み

1. 📡 MCP サーバーは get_docs ツールを Claude に公開します
2. 🔍 ツールが呼び出されると、Serper API を使ってドキュメントを検索します
3. 📚 検索結果からコンテンツをスクレイピングします
4. 🔄 分析と説明のため、コンテンツを Claude に返します

🛠️ 詳細設定

新しいドキュメントソースの追加

main.py の docs_urls 辞書を拡張します。

docs_urls = {
    "langchain": "python.langchain.com/docs",
    "llama-index": "docs.llamaindex.ai/en/stable",
    "openai": "platform.openai.com/docs",
    "huggingface": "huggingface.co/docs",  # Add new documentation sources
    "tensorflow": "www.tensorflow.org/api_docs",
}

検索動作のカスタマイズ

search_web 関数を変更して、検索結果の件数を調整します。

payload = json.dumps({"q": query, "num": 5})  # Increase from default 2

🔍 トラブルシューティング

よくある問題

• 🚫 「Connection refused」エラー: Claude を接続する前に MCP サーバーが実行中であることを確認してください
• ⏱️ タイムアウトエラー: インターネット接続を確認するか、タイムアウト値を増やしてください
• 🔒 API キーの問題: .env ファイルの Serper API キーが正しいことを確認してください

デバッグのヒント

main.py ファイルを変更して、より詳細なログを追加します。

import logging
logging.basicConfig(level=logging.DEBUG)

📈 パフォーマンスの最適化

• ⚡ 応答を高速化するには、頻繁にアクセスするドキュメントをキャッシュすることを検討してください
• 🧠 トークン数の制限を避けるため、Claude に返すテキスト量を制限してください
• 🌐 より関連性の高いドキュメントを取得するには、検索クエリを具体的にしてください

🤝 貢献

貢献を歓迎します。以下の方法でご協力いただけます。

1. 🍴 リポジトリをフォークします
2. 🌿 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 💾 変更をコミットします（git commit -m 'Add some amazing feature'）
4. 📤 ブランチにプッシュします（git push origin feature/amazing-feature）
5. 🔍 Pull Request を作成します

📜 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• Claude を開発した Anthropic
• 検索 API を提供する Serper.dev
• このプロジェクトを実現しているすべてのオープンソースライブラリ

---