Python MCP Server Sample

🚀 uv项目使用指南

本项目主要围绕uv工具展开，可用于创建Python项目、安装MCP SDK、构建MCP服务器并将其注册到Cline，为开发提供便利。

🚀 快速开始

📦 安装指南

使用以下命令安装uv：

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

💻 使用示例

基础用法

• 创建Python项目 使用uv创建名为mcp-server-demo的Python项目：

# 创建名为mcp-server-demo的Python项目
uv init mcp-server-demo

• 安装MCP SDK 进入项目目录并添加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
    }
  }
}