AI导哈

安全表达式计算器

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

  • by xiaoyingv
  • HTML
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 xiaoyingv/mcp_calculate_server

使用说明

Calculator MCP Server 🧮

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

功能特性

  • ✅ 支持加减乘除四则运算（+, -, *, /）
  • ✅ 支持幂运算（**）
  • ✅ 支持正负号处理（+5, -3）
  • ✅ 智能格式化计算结果：
    • 整数结果直接显示整数
    • 小数结果保留最多15位有效数字
    • 自动去除末尾多余的零
  • ⚠️ 安全防护：
    • 拦截代码注入风险（通过 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"

>>> perform_calculation("10/3")
"🧮 计算结果：10/3 = 3.333333333333333"

>>> perform_calculation("10**20")
"🧮 计算结果：10**20 = 100000000000000000000"

>>> perform_calculation("2**3")
"🧮 计算结果：2**3 = 8"

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

>>> perform_calculation("0**-1")
"❌ 错误：零的负数次幂未定义"

>>> perform_calculation("(-1)**0.5")
"❌ 错误：负数的非整数次幂未定义"

支持的运算符

操作符 说明 示例
+ 加法 3+4
- 减法 5-2
* 乘法 6*7
/ 除法 8/2
** 幂运算 2**3
-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

相关 MCP