自定义 MCP 本地服务搭建：stdio 与 SSE 模式及 AI 工具调用

代码核心说明

1. FastMCP("Demo")：快速初始化 MCP 服务，Demo 为服务名称，在 Cherry Studio 中会显示该名称
2. 三大核心装饰器： @mcp.tool()：标记可调用工具，AI 能直接执行并返回结果（如加法计算） @mcp.resource()：标记资源服务，通过自定义协议提供静态 / 动态资源（如个性化问候） @mcp.prompt()：标记提示词工具，为 AI 生成指定风格的内容提供模板

六、客户端准备：安装 Cherry Studio（MCP 联调工具）

Cherry Studio 是一款专为 MCP 协议设计的 AI 客户端，能无缝对接自定义 MCP 服务，无需复杂的接口配置，是测试自定义 MCP 服务的最佳工具。

1. 下载安装

官网下载地址：请前往 Cherry Studio 官网下载安装

支持 Windows/macOS 系统，一键安装无附加组件 安装完成后打开，完成基础注册 / 登录（免费可用）

2. 安装 Cherry 内置工具（基础准备）

添加 MCP 服务器

七、关键步骤：Cherry Studio 添加自定义 MCP 服务

输入完后，点保存并打开。

八、联调测试：验证自定义 MCP 服务是否生效

回到首页，输入使用 MCP 1+3 等于多少？发送输出 5 证明已调用到我们自己写的 MCP 服务中。

九、在 Trace 中配置 MCP stdio 模式使用

1. 配置 mcp:

{
  "mcpServers": {
    "mcp-stdio-add": {
      "command": "python",
      "args": ["D:\\AiMcpProject\\mcp_server\\main.py"],
      "env": {}
    }
  }
}

2. 输入 使用 mcp-stdio-add 工具计算 1+3 的和，发送即可

十、运行 MCP SSE 模式

main.py 配置 SSE 和端口 8001

if __name__ == "__main__":
    mcp.settings.port = 8001
    mcp.run(transport="sse")

完整代码（可直接复制使用）

from mcp.server import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")

# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b + 1

# 多加 1 测试是走了我们自己的 mcp

# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

# Add a prompt
@mcp.prompt()
def greet_user(name: str, style: str = "friendly") -> str:
    """Generate a greeting prompt"""
    styles = {
        "friendly": "Please write a warm, friendly greeting",
        "formal": "Please write a formal, professional greeting",
        "casual": "Please write a casual, relaxed greeting",
    }
    return f"{styles.get(style, styles['friendly'])} for someone named {name}."

# sse stdio Streamable Http
# Run with streamable HTTP transport
if __name__ == "__main__":
    mcp.settings.port = 8001
    mcp.run(transport="sse")

运行程序：

Trace 配置 MCP SSE:

输入 使用 mcp-stdio-add 工具计算 1+3 的和，发送即可，会输出结果 和 python 端输出接口请求