Python MCP Server Sample

🚀 uv項目使用指南

本項目提供了一套便捷的工具和流程，用於創建、配置和運行MCP服務器，幫助開發者更高效地進行相關開發工作。

🚀 快速開始

📦 安裝uv

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

🐍 Python項目創建

# 創建名為mcp-server-demo的Python項目
uv init mcp-server-demo

📥 MCP SDK安裝

# 進入mcp-server-demo項目目錄
cd mcp-server-demo
# 在mcp-server-demo項目中添加MCP SDK
uv add "mcp[cli]"

🏗️ 構建MCP服務器

創建文件

創建server.py文件（文件名可任意）：

mv main.py server.py

編寫代碼

在server.py中添加以下代碼：

from mcp.server.fastmcp import FastMCP

# 創建一個帶有調試功能的MCP服務器
mcp = FastMCP("Demo", debug=True)

# 添加一個加法工具
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

# 添加這部分代碼以運行服務器
if __name__ == "__main__":
    # 使用stdio傳輸啟動服務器
    print("Starting MCP server in stdio mode")
    mcp.run(transport="stdio")

📝 註冊MCP服務器到Cline

編輯Cline項目的MCP文件如下：

{
  "mcpServers": {
    "mcp-demo-server": {
      "command": "uv",
      "args": [
        "--directory",
        <path to mcp-server-demo>,
        "run",
        "server.py"
      ],
      "alwaysAllow": [
        "add"
      ],
      "disabled": false
    }
  }
}