🤖 Claude AI 文档助理 📚

👁 Claude + MCP 集成

强大的 MCP 服务器，为 Claude 提供文档搜索功能

👁 Python 3.8+
👁 许可证：MIT
👁 欢迎 PR

✨ 特点

• 🔍智能文档搜索- 跨多个 AI/ML 库文档进行搜索

• 🧠 Claude 集成- 与 Claude 高级推理能力无缝连接

• 🌐智能网页搜索- 利用 Serper API 进行有针对性的文档查找

• 💨快速响应时间——针对快速检索和处理进行了优化

• 🧩可扩展架构- 轻松添加更多文档源

Related MCP server: DocuMCP

📋 先决条件

• 🐍 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. ⚙️ 点击您的个人资料图标并选择“设置”

3. 🧰 导航至“工具”部分

4. ➕ 点击“添加工具”

5. 🔗 选择“连接到本地工具”

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 服务器向 Claude 公开了一个get_docs工具

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

🔍 故障排除

常见问题

• 🚫 “连接被拒绝”错误：在连接 Claude 之前，请确保 MCP 服务器正在运行

• ⏱️ 超时错误：检查您的互联网连接或增加超时值

• 🔒 API 密钥问题：验证.env文件中的 Serper API 密钥是否正确

调试技巧

通过修改 main.py 文件添加更详细的日志记录：

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

📈 性能优化

• ⚡ 为了加快响应时间，请考虑缓存经常访问的文档

• 🧠 限制返回给 Claude 的文本量，以避免令牌限制

• 🌐 使用更具体的查询来获取更多相关文档

🤝 贡献

欢迎贡献！您可以通过以下方式提供帮助：

1. 🍴 Fork 仓库

2. 🌿 创建功能分支（ git checkout -b feature/amazing-feature ）

3. 💾 提交你的更改（ git commit -m 'Add some amazing feature' ）

4. 📤 推送到分支（ git push origin feature/amazing-feature ）

5. 🔍 打开拉取请求

📜 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• 人类创造了克劳德

• Serper.dev的搜索 API

• 使该项目成为可能的所有开源库

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers