MCP服务器教程

本仓库包含一个使用 FastMCP 构建的简单 MCP (模型上下文协议) 服务器。该服务器提供各种数学运算作为工具，可以通过 MCP 协议使用。

功能特性

• 基本算术运算（加法、减法、乘法、除法）

• 高级数学函数：

  • 幂运算
  • 平方根
  • 立方根
  • 阶乘
  • 对数
  • 三角函数（sin、cos、tan）
  • 求余

• 动态问候资源

前提条件

• Python 3.8 或更高版本
• FastMCP 库

安装

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

   uv venv
   source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate
   

3. 安装依赖：

   uv install fastmcp
   

使用方法

运行服务器

使用以下命令运行服务器：

python main.py

服务器默认使用 SSE (服务器发送事件) 传输，允许您使用 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: 服务器发送事件（基于浏览器，与 MCP Inspector 兼容）

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