MCP 文档搜索服务器

该项目实现了一个自定义的 MCP（模型控制协议）服务器，允许Claude通过文档搜索来查找流行 Python 库，包括LangChain、LlamaIndex 和 OpenAI。

功能

• 在支持的库中搜索特定查询的文档
• 通过 Serper 集成 Google Search API 找到相关文档页面
• 具备网页抓取功能以提取文档页面内容
• 设计用于与 Claude Desktop 一起使用，通过 MCP 连接

系统要求

• 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 日志中的任何错误消息