MCP Calculator Demo

MCP Calculator Demo

一个演示项目，展示如何使用 MCP（Model Control Protocol）框架构建计算器服务。该项目包含一个提供基本算术运算的服务端，以及一个能够计算简单和复杂数学表达式的客户端。

项目结构

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

功能

• 基本算术运算（加法、减法、乘法、除法）
• 支持简单运算（例如，“add 2 3”）和复杂表达式
• 处理除以零的错误
• 客户端与服务端之间通过服务器发送事件（SSE）通信
• 支持表达式中的括号
• 使用 RPN（逆波兰表示法）计算复杂表达式

先决条件

• Python 3.7+
• pip（Python 包管理器）

安装

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

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 安装依赖项：

   pip install -r requirements.txt
   

使用方法

启动服务端

运行计算器服务端：

python calculator_server.py

服务端默认将在 http://127.0.0.1:5005 上启动。

运行客户端

在另一个终端中运行客户端：

python client.py

可用运算

计算器支持以下运算：

1. 直接工具语法：

   • add 2 3
   • subtract 5 2
   • multiply 4 3
   • divide 10 2

2. 复杂表达式：

   • 5+7-2
   • 5+7-2*3
   • (5+7)*2
   • 10/2+3*4

使用示例

» add 2 3
Result: 5

» 5+7-2*3
Result: 6

» (5+7)*2
Result: 24

» divide 10 0
Error: Division by zero.

技术详情

• 服务端使用 FastMCP 处理 MCP 操作
• 客户端与服务端之间通过服务器发送事件（SSE）通信
• 客户端使用调度场算法解析复杂表达式
• 针对无效表达式和除以零的情况实现了错误处理

依赖项

• fastapi
• uvicorn
• sse-starlette
• fastmcp>=0.1.0
• llama-index
• llama-index-llms-anthropic
• anthropic
• python-dotenv
• requests
• sseclient-py
• uv

许可证

本项目采用开源方式发布，并遵循 MIT 许可证。