Documentation MCP Server 📚🔍

文档 MCP 服务 📚🔍

一个模型上下文协议（MCP）服务，可让 Claude 在对话中直接搜索和访问 LangChain、LlamaIndex 和 OpenAI 等热门库的文档。

什么是 MCP？🤔

MCP（模型上下文协议）是一种开放协议，用于标准化应用程序向大语言模型提供上下文的方式。可以把它看作一个通用连接器，让 Claude 等 AI 助手能够访问外部数据源和工具。

功能 ✨

• 文档搜索工具：搜索热门 AI 库的文档
• 支持的库：
  • LangChain 🔗
  • LlamaIndex 🦙
  • OpenAI 🤖
• 智能提取：智能解析 HTML 内容，提取最相关的信息
• 结果可配置：根据需要限制返回的文本量

工作原理 🛠️

1. 服务使用 Serper API，通过指定网站的查询执行 Google 搜索
2. 服务获取搜索结果中的内容
3. BeautifulSoup 从主要内容区域提取最相关的文本
4. Claude 可通过 get_docs 工具访问这些信息

系统要求 🖥️

• Python 3.11 或更高版本
• uv 包管理器
• Serper API 密钥

设置说明 🚀

1. 安装 uv 包管理器

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 克隆并设置项目

# Clone or download the project
cd documentation

# Create and activate virtual environment
uv venv
# On Windows:
.venv\Scripts\activate
# On macOS/Linux:
source .venv/bin/activate

# Install dependencies
uv pip install -e .

3. 配置 Serper API 密钥

在项目目录中创建一个 .env 文件，并填入你的 Serper API 密钥：

SERPER_API_KEY=your_serper_api_key_here

你可以在 serper.dev 注册以获取 Serper API 密钥。

4. 配置 Claude Desktop

编辑 Claude Desktop 配置文件：

• Windows：/C:/Users/[Your Username]/AppData/Roaming/Claude/claude_desktop_config.json

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

将以下内容添加到 mcpServers 部分：

"documentation": {
  "command": "uv",
  "args": [
    "--directory",
    "/ABSOLUTE/PATH/TO/YOUR/documentation",
    "run",
    "main.py"
  ]
}

将 /ABSOLUTE/PATH/TO/YOUR/documentation 替换为项目目录的绝对路径。

5. 重启 Claude Desktop

关闭并重新打开 Claude Desktop，以应用新配置。

使用文档工具 🧩

连接后，你可以让 Claude 使用文档工具：

“你能查找 LangChain 文档中有关向量存储的信息吗？”

Claude 将使用 get_docs 工具搜索相关信息，并向你提供文档摘录。

工具参数 📋

get_docs 工具接受以下参数：

• query：搜索词（例如，“向量存储”“嵌入模型”）
• library：要搜索的库（langchain、llama-index 或 openai）
• max_chars：返回的最大字符数（默认值：1000）

故障排除 🛠️

• Claude 找不到服务：确认 /C:/Users/fcbsa/AppData/Roaming/Claude/claude_desktop_config.json 中的路径正确
• 搜索没有返回结果：检查 Serper API 密钥和互联网连接
• 超时错误：服务可能遇到了连接问题或速率限制

许可证 📜

本项目作为 MCP 服务实现的教学示例提供。

致谢 🙏

• 使用 MCP SDK 构建
• 使用 Serper API 提供 Google 搜索集成
• 使用 BeautifulSoup4 解析 HTML
• 灵感来自不断壮大的 MCP 社区

---

此 MCP 服务通过提供对文档资源的直接访问，增强了 Claude 的能力。利用文档中的上下文知识，探索、学习并构建更出色的 AI 应用！