🚀 mcp-server 中文指南

一个简单的 MCP 服务端，允许获取一些工具（如 langchain、openai、lama-index）的最新文档，为开发者提供便捷的文档获取途径，提升开发效率。

🚀 快速开始

系统需求

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

安装 uv 包管理器

在 MacOS/Linux 上，可通过以下命令安装 uv 包管理器：

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

⚠️ 重要提示： 请确保之后重启终端，以使 uv 命令生效。

项目设置

1. 创建并初始化项目：

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

# 创建虚拟环境并激活它
uv venv
source .venv/bin/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": "/ABSOLUTE/PATH/TO/YOUR/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 日志中的任何错误信息。