🚀 MCP 服务器教程

本仓库提供了一个借助 FastMCP 搭建的简易 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 参数即可。