MCP Server Tutorial

MCP 服务教程

此代码仓库包含一个使用 FastMCP 构建的简单 MCP（Model Context Protocol）服务。该服务提供各种数学运算作为工具，可通过 MCP 协议使用。

功能

• 基本算术运算（加法、减法、乘法、除法）
• 高级数学函数：
  • 幂运算
  • 平方根
  • 立方根
  • 阶乘
  • 对数
  • 三角函数（sin、cos、tan）
  • 余数
• 动态问候语资源

前置条件

• Python 3.8 或更高版本
• FastMCP 库

安装

1. 克隆此代码仓库
2. 创建并激活虚拟环境：

   uv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. 安装依赖项：

   uv install fastmcp
   

使用方法

运行服务

使用以下命令运行服务：

python main.py

服务默认使用 SSE（Server-Sent Events）传输方式，因此可以使用 MCP Inspector 连接。

使用 MCP Inspector 连接

1. 打开 MCP Inspector

npx @modelcontextprotocol/inspector

3. 选择 SSE 传输类型
4. 连接到服务 URL（通常为 http://localhost:8000/sse）
5. 现在可以使用服务中定义的数学工具和资源

可用工具

• add(a, b)：将两个数相加
• subtract(a, b)：将两个数相减
• multiply(a, b)：将两个数相乘
• divide(a, b)：将两个数相除
• power(a, b)：计算 a 的 b 次幂
• sqrt(a)：计算一个数的平方根
• cbrt(a)：计算一个数的立方根
• factorial(a)：计算一个数的阶乘
• log(a)：计算一个数的自然对数
• remainder(a, b)：计算 a 除以 b 的余数
• sin(a)：计算一个数的正弦值
• cos(a)：计算一个数的余弦值
• tan(a)：计算一个数的正切值

可用资源

• greeting://{name}：根据给定名称返回个性化问候语

修改服务

你可以按照 main.py 中的模式添加更多工具和资源：

1. 要添加新工具，请使用 @mcp.tool() 装饰器
2. 要添加新资源，请使用 @mcp.resource() 装饰器

传输选项

FastMCP 支持两种传输协议：

• stdio：标准输入/输出（基于终端）
• sse：Server-Sent Events（基于浏览器，与 MCP Inspector 兼容）

要更改传输协议，请修改 mcp.run() 调用中的 transport 参数。