文档 MCP 服务器 📚🔍

一个模型上下文协议（MCP）服务器，使Claude可以直接在对话中搜索并访问流行库（如LangChain、LlamaIndex和OpenAI）的文档。

什么是MCP？ 🤔

MCP（Model Context Protocol）是一个开放协议，标准化了应用程序向大型语言模型提供上下文的方式。可以将其视为通用连接器，使AI助手如Claude能够直接访问外部数据源和工具。

功能 ✨

• 文档搜索工具：在流行的人工智能库中搜索文档
• 支持的库：
  • 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. 克隆并设置项目

# 克隆或下载项目
cd 文档

# 创建并激活虚拟环境
uv venv
# 在Windows上：
.venv\Scripts\activate
# 在macOS/Linux上：
source .venv/bin/activate

# 安装依赖项
uv pip install -e .

3. 配置Serper API密钥

在项目目录中创建一个.env文件，并添加您的Serper API密钥：

SERPER_API_KEY=your_serper_api_key_here

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

4. 配置Claude桌面

编辑您的Claude桌面配置文件（位置因系统而异）：

• 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. 启动服务器

运行以下命令启动MCP服务器：

uv run main.py

使用说明 📱

启动后，Claude可以通过调用get_docs函数来搜索和访问指定库的文档。例如：

print(get_docs("langchain"))  # 搜索LangChain相关文档

图片示例

工具参数 🛠️

• get_docs(query: str)：根据查询返回相关文档内容。
• 参数：
  • query（必需）：要搜索的关键词或短语。
• 示例：

  print(get_docs("llama"))  # 搜索LlamaIndex相关内容
  

注意事项

• 确保安装了所有依赖项，并且Python版本符合要求。
• 配置文件路径正确，以便Claude能够识别MCP服务器。
• 如有任何问题，请检查控制台输出或查阅文档。