MCP Server Tutorial 7f7

🚀 MCP 服务器教程

本仓库包含一个借助 FastMCP 构建的简易 MCP（模型上下文协议）服务器。该服务器提供了丰富的数学运算工具，可通过 MCP 协议使用，为用户在数学计算方面提供了便利。

🚀 快速开始

此 MCP 服务器能让您轻松使用多种数学运算工具，按照以下步骤，您可以快速搭建并运行服务器。

✨ 主要特性

• 基本算术运算：支持加法、减法、乘法、除法等基础运算。
• 高级数学函数：涵盖次方、平方根、立方根、阶乘、对数、三角函数（正弦、余弦、正切）以及取模等复杂运算。
• 动态问候资源：可根据给定名称返回个性化问候语。

📦 安装指南

先决条件

• Python 3.8 或更高版本
• FastMCP 库

安装步骤

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

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

3. 安装依赖项：

   uv install fastmcp
   

💻 使用示例

运行服务器

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

python main.py

该服务器默认采用 SSE（服务器发送事件）传输，您可使用 MCP Inspector 进行连接。

与 MCP Inspector 连接

1. 打开 MCP Inspector：

npx @modelcontextprotocol/inspector

2. 选择 SSE 传输类型。
3. 连接到服务器 URL（通常为 http://localhost:8000/sse）。
4. 此时您便可以与服务器定义的数学工具和资源进行交互。

可用工具

• 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 参数。