Docs MCP Server

Docs MCP 服务

此代码仓库包含 Model Context Protocol（MCP）服务的一种实现。

此 MCP 服务 """ 根据给定的查询和库搜索最新文档。 支持 langchain、openai 和 llama-index。

参数： query：要搜索的查询（例如“Chroma DB”） library：要搜索的库（例如“langchain”）

返回： 文档中的文本 """

什么是 MCP？

MCP（Model Context Protocol）是一种开放协议，用于规范应用程序向大模型提供上下文的方式。可以将 MCP 看作 AI 应用的 USB-C 接口——它提供了一种标准化方式，可将 AI 模型连接到不同的数据源和工具。

主要优势

• 不断增长的预构建集成列表，大模型可直接接入
• 可灵活切换大模型提供商和供应商
• 在自身基础设施中保护数据的最佳实践

架构概览

MCP 采用客户端-服务端架构，宿主应用可以连接多个服务：

• MCP 宿主：Claude Desktop、IDE 或 AI 工具等程序，可通过 MCP 访问数据
• MCP 客户端：与服务保持一对一连接的协议客户端
• MCP 服务：通过标准化的 Model Context Protocol 提供特定功能的轻量级程序
• 数据源：MCP 服务可以访问的本地数据（文件、数据库）和远程服务（API）

MCP 核心概念

MCP 服务可以提供三种主要类型的功能：

• 资源：客户端可以读取的类文件数据（例如 API 响应或文件内容）
• 工具：大模型可以调用的函数（需经用户批准）
• 提示词：帮助用户完成特定任务的预先编写模板

系统要求

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

快速开始

安装 uv 包管理器

在 MacOS/Linux 上：

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

之后请务必重新启动终端，以确保系统能够识别 uv 命令。

项目设置

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

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",  # It's better to use the absolute path to the uv command
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

3. 重启 Claude Desktop

故障排除

如果 Claude Desktop 未能识别你的服务：

1. 检查配置文件路径和权限
2. 确认配置中的绝对路径正确
3. 确保已正确安装并可访问 uv
4. 检查 Claude Desktop 日志中的错误消息