MCP Calculator Demo

基本能力

产品定位

MCP Calculator Demo 是一个基于 MCP 框架的计算器服务演示项目，旨在展示如何使用 MCP 框架实现基本的算术运算和复杂表达式的处理。

核心功能

• 基本算术运算（加法、减法、乘法、除法）
• 支持简单操作（如 "add 2 3"）和复杂表达式
• 处理除零错误
• 使用 Server-Sent Events (SSE) 进行客户端和服务器之间的通信
• 支持表达式中的括号
• 使用 RPN (Reverse Polish Notation) 评估复杂表达式

适用场景

• 开发人员学习和理解 MCP 框架的使用
• 需要快速实现一个计算器服务的场景
• 需要处理复杂数学表达式的场景

工具列表

• calculator_server.py: MCP 服务器，提供算术运算
• client.py: 客户端应用程序，连接服务器并处理用户输入
• requirements.txt: 项目依赖

常见问题解答

• 如何处理除零错误？服务器会返回 "Error: Division by zero."
• 如何支持复杂表达式？客户端实现了 Shunting-Yard 算法来解析复杂表达式

使用教程

使用依赖

• Python 3.7+
• pip (Python 包管理器)

安装教程

1. 克隆仓库
2. 创建并激活虚拟环境： bash python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
3. 安装依赖： bash pip install -r requirements.txt

调试方式

1. 启动服务器： bash python calculator_server.py 服务器默认运行在 http://127.0.0.1:5005

2. 运行客户端： bash python client.py

3. 可用操作：

4. 直接工具语法： add 2 3 subtract 5 2 multiply 4 3 divide 10 2
5. 复杂表达式： 5+7-2 5+7-2*3 (5+7)*2 10/2+3*4

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。