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協議官方文檔