用于文档搜索的 MCP 服务器

该项目实现了一个自定义的 MCP (模型控制协议) 服务器，使 Claude 能够搜索包括 LangChain、LlamaIndex 和 OpenAI 在内的流行 Python 库的文档。

功能

• 搜索受支持库中特定查询的文档
• 通过 Serper 集成 Google Search API，以查找相关的文档页面
• 具有网络抓取功能，可以从文档页面提取内容
• 旨在通过 MCP 与 Claude Desktop 配合使用

系统要求

• Python 3.10 或更高版本
• MCP SDK 1.2.0 或更高版本
• uv 包管理器

快速入门

安装 uv 包管理器

在 MacOS/Linux 上：

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

在 Windows 上：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

请务必之后重启您的终端，以确保 uv 命令被识别。有关 uv 包管理器的更多信息，请访问：https://docs.astral.sh

项目设置

1. 创建并初始化项目：

# 为我们的项目创建一个新目录
uv init mcp-server
cd mcp-server

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

# 安装依赖项
uv add "mcp[cli]" httpx

2. 创建服务器实现文件：

touch main.py

运行服务器

1. 启动 MCP 服务器：

uv run main.py

2. 服务器将启动并准备好接受连接

连接到 Claude Desktop

1. 从官方网站安装 Claude Desktop
2. 配置 Claude Desktop 以使用您的 MCP 服务器：

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  // 最好使用 uv 命令的绝对路径
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. 重启 Claude Desktop

故障排除

如果您的服务器未被 Claude Desktop 识别：

1. 检查配置文件路径和权限
2. 验证配置中的绝对路径是否正确
3. 确保 uv 已正确安装且可访问
4. 检查 Claude Desktop 日志中是否有任何错误消息