MCP Demo

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

本指南将指导您如何使用Python、FastMCP和uv，在Windows和macOS/Linux系统上设置兼容Claude的MCP服务器。该服务器能为您在相关应用场景中提供有力支持，助您高效开展工作。

🚀 快速开始

✅ 先决条件

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

📦 安装指南

使用uv安装mcp包

在终端中运行以下命令：

uv add "mcp[cli]"

安装Claude是强制性的

📁 步骤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}!"

📦 步骤2：安装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

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

🚀 步骤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协议官方文档