文档搜索服务

MCP服务器实现Python库文档搜索功能,支持LangChain、LlamaIndex和OpenAI等库的文档查询与集成。

  • by deepmihir
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 deepmihir/mcp-server-tutorial

使用说明

MCP文档搜索服务器

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

特性

  • 在支持的库中搜索特定查询的文档
  • 通过Serper与Google Search API集成以查找相关文档页面
  • 从文档页面提取内容的Web抓取功能
  • 设计用于通过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. 创建并初始化项目:
# Create a new directory for our project
uv init mcp-server
cd mcp-server

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

# Install dependencies
uv add "mcp[cli]" httpx
  1. 创建服务器实现文件:
touch main.py

运行服务器

  1. 启动MCP服务器:
uv run main.py
  1. 服务器将启动并准备接受连接

连接到克劳德桌面

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

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

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # It's better to use the absolute path to the uv command
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}
  1. 重新启动克劳德桌面

故障排除

如果您的服务器未被Claude Desktop接收:

  1. 检查配置文件路径和权限
  2. 验证配置中的绝对路径是否正确
  3. 确保紫外线正确安装且易于接近
  4. 检查Claude Desktop日志中是否有任何错误消息