MCP Server for Documentation Search

MCP Server for Documentation Search

site icon
2025.04.15 0
Python文档搜索Python 工具开发效率
MCP-Server-Tutorial 是一个基于 MCP(Model Control Protocol)的自定义服务器,主要用于帮助 Claude 搜索 Python 流行库(如 LangChain、LlamaIndex 和 OpenAI)的文档。该服务器集成了 Google Search API(通过 Serper)和网页抓取功能,能够高效地从文档页面提取内容。
View on GitHub

Overview

基本能力

产品定位

MCP-Server-Tutorial 是一个文档搜索工具,专为开发者和研究人员设计,用于快速查找和提取 Python 库的文档内容。

核心功能

  • 支持跨多个 Python 库(如 LangChain、LlamaIndex 和 OpenAI)的文档搜索
  • 通过 Serper 集成 Google Search API,查找相关文档页面
  • 提供网页抓取功能,从文档页面提取内容
  • 设计用于与 Claude Desktop 通过 MCP 协议交互

适用场景

  • 开发者在编写代码时需要快速查找 Python 库的文档
  • 研究人员需要从多个来源收集和整理技术文档
  • 自动化工具需要集成文档搜索功能

工具列表

  • uv 包管理器:用于项目初始化和依赖管理
  • mcp[cli]:MCP 协议的客户端工具
  • httpx:HTTP 客户端库,用于网络请求

常见问题解答

  1. 服务器未被 Claude Desktop 识别
  2. 检查配置文件路径和权限
  3. 验证配置文件中的绝对路径是否正确
  4. 确保 uv 已正确安装并可访问
  5. 查看 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"

安装教程

  1. 创建并初始化项目:
uv init mcp-server
cd mcp-server
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv add "mcp[cli]" httpx
  1. 创建服务器实现文件:
touch main.py

调试方式

  1. 启动 MCP 服务器:
uv run main.py
  1. 配置 Claude Desktop 使用 MCP 服务器: 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json
{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}
  1. 重启 Claude Desktop

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。