mcp-calculate-server 0.1.1

计算器MCP服务,输入字符串的计算式，返回计算结果

Calculator MCP Server 🧮

基于 Python AST 的安全表达式计算器 MCP 服务，支持基础数学运算和错误防护机制。

功能特性

• ✅ 支持加减乘除四则运算（+, -, *, /）
• ✅ 支持正负号处理（+5, -3）
• ✅ 自动格式化计算结果（保留两位小数）
• ⚠️ 安全防护：
  • 拦截代码注入风险（通过 AST 解析而非 eval）
  • 除零错误防护
  • 语法错误提示
  • 类型安全检查

安装方式

pip install mcp-calculate-server

快速使用

from mcp.server.fastmcp import FastMCP

# 启动计算器服务
calculator = FastMCP("CalculatorServer")
calculator.run(transport='stdio')

API 接口

perform_calculation(expression: str) -> str

接收数学表达式字符串，返回格式化结果或错误信息

>>> perform_calculation("5+3")
"🧮 计算结果：5+3 = 8.00"

>>> perform_calculation("10/0")
"❌ 错误：除数不能为零"

>>> perform_calculation("2**3")
"❌ 不支持的运算符：Power"

支持的运算符

操作符	说明	示例
+	加法	3+4
-	减法	5-2
*	乘法	6*7
/	除法	8/2
-x	取负	-5
+x	取正	+3

错误码说明

错误类型	示例输出
语法错误	❌ 表达式语法错误：unexpected EOF
不支持的运算符	❌ 不支持的运算符：Mod
除零错误	❌ 错误：除数不能为零
非法操作数类型	TypeError: 不支持的常量类型

依赖环境

• Python 3.13+
• mcp-server 库（自动安装）

开源协议

MIT License，详情见 LICENSE

源码地址

GitHub: https://github.com/xiaoyingv/mcp_calculate_server

贡献指南

欢迎提交 PR 和报告 issue，提交前请阅读 [CONTRIBUTING.md]

请根据实际情况修改以下内容：
1. 替换 GitHub 仓库地址和 PyPI 的 badge 链接
2. 添加实际版本号（当前使用占位符）
3. 补充测试说明或更多使用示例（如有）
4. 如果需要，可添加 CI/CD 状态徽章

这个 README 包含：

- 清晰的功能列表和安全特性
- 使用示例和错误处理说明
- API 接口文档
- 支持的操作符表格
- 错误码说明
- 安装和开发信息
- 开源协议和贡献指引