MCP Demo

🚀 兼容Claude的MCP服务器设置指南

本指南将指导您如何使用Python、FastMCP和uv，在Windows和macOS/Linux系统上设置兼容Claude的MCP服务器，助您快速搭建所需的服务器环境。

🚀 快速开始

按照以下步骤，您可以轻松完成兼容Claude的MCP服务器的设置：

1. 确保满足先决条件。
2. 使用uv安装mcp包。
3. 创建MCP服务器文件main.py。
4. 安装uv。
5. 启动MCP服务器。
6. （可选）进行手动测试。

✨ 主要特性

• 支持在Windows、macOS/Linux系统上设置。
• 利用Python、FastMCP和uv实现Claude兼容的MCP服务器。

📦 安装指南

✅ 先决条件

• Python ≥ 3.12（由mcp-example要求）
• 已安装uv
• 终端（命令提示符、PowerShell或Bash）

使用uv安装mcp包

在终端中运行以下命令：

uv add "mcp[cli]"

安装uv

🪟 Windows

1. 以管理员身份打开PowerShell。
2. 运行以下命令：

irm https://astral.sh/uv/install.ps1 | iex

这将把uv安装到%USERPROFILE%\.cargo\bin\uv。

可选：如果需要手动添加到PATH，请运行：

$env:Path += ";$HOME\.cargo\bin"

然后关闭并重新打开终端。

🍎 macOS / 🐧 Linux

在终端中运行以下命令：

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

如果需要添加到shell的配置文件，请运行：

export PATH="$HOME/.local/bin:$PATH"

测试一下：

uv --version

✅ 如果看到版本号，说明安装成功。

💻 使用示例

基础用法

📁 步骤1：创建您的MCP服务器（main.py）

在项目文件夹中，创建一个名为main.py的文件：

from mcp.server.fastmcp import FastMCP
import sys

print("✅ MCP服务器运行情况：", sys.version)

# 创建MCP服务器
mcp = FastMCP("Demo")

# 添加一个简单的工具
@mcp.tool()
def add(a: int, b: int) -> int:
    """添加两个数字"""
    return a + b

# 添加一个动态问候资源
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """返回个性化的问候"""
    return f"你好，{name}!"

高级用法

🚀 步骤3：启动您的MCP服务器

现在注册并运行兼容Claude的服务器：

uv run mcp install main.py

此命令将：

• 使用uv动态安装mcp[cli]。
• 验证您的main.py服务器。
• 注册以供Claude使用（如果集成）。

🧪 步骤4（可选）：手动测试

要验证是否正常运行，请运行以下命令：

uv run main.py

然后在另一终端中，您可以测试工具和资源：

curl http://localhost:1234/_/add?tool=add\&a=1\&b=2
curl http://localhost:1234/_/greeting?resource=greeting%3A%2F%2Ftest

📚 详细文档

故障排除

错误信息：spawn uv ENOENT

• 原因：未安装或未正确配置uv。
• 解决方法：按照uv安装指南重新安装并配置uv。

📝 其他注意事项

• 确保服务器在运行时有适当的权限。
• 查看MCP协议的详细信息，请参考MCP协议文档。

一些额外资源

• 在本地免费运行MCP服务器：GitHub示例
• 阅读更多关于MCP协议的信息：MCP协议官方文档