🚀 MCP 服务器教程
本仓库包含一个借助 FastMCP 构建的简易 MCP（模型上下文协议）服务器。该服务器提供了丰富的数学运算工具，可通过 MCP 协议使用，为用户在数学计算方面提供了便利。
🚀 快速开始
此 MCP 服务器能让您轻松使用多种数学运算工具，按照以下步骤，您可以快速搭建并运行服务器。
✨ 主要特性
- 基本算术运算：支持加法、减法、乘法、除法等基础运算。
- 高级数学函数：涵盖次方、平方根、立方根、阶乘、对数、三角函数（正弦、余弦、正切）以及取模等复杂运算。
- 动态问候资源：可根据给定名称返回个性化问候语。
📦 安装指南
先决条件
- Python 3.8 或更高版本
- FastMCP 库
安装步骤
- 克隆此仓库。
- 创建并激活虚拟环境：
uv venv source venv/bin/activate # 在 Windows 上：vvenv\Scripts\activate - 安装依赖项：
uv install fastmcp
💻 使用示例
运行服务器
使用以下命令运行服务器：
python main.py
该服务器默认采用 SSE（服务器发送事件）传输，您可使用 MCP Inspector 进行连接。
与 MCP Inspector 连接
- 打开 MCP Inspector：
npx @modelcontextprotocol/inspector
- 选择 SSE 传输类型。
- 连接到服务器 URL（通常为 http://localhost:8000/sse）。
- 此时您便可以与服务器定义的数学工具和资源进行交互。
可用工具
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 中的模式，您可以添加更多工具和资源：
- 若要添加新工具，请使用
@mcp.tool()装饰器。 - 若要添加新资源，请使用
@mcp.resource()装饰器。
传输选项
FastMCP 支持两种传输协议：
stdio: 标准输入/输出（基于终端）sse: 服务器发送事件（基于浏览器，与 MCP Inspector 兼容）
若要更改传输协议，请修改 mcp.run() 调用中的 transport 参数。