mcp_calculate_server

xiaoyingv/mcp_calculate_server

3.3

If you are the rightful owner of mcp_calculate_server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Calculator MCP Server is a secure expression calculator service based on Python AST, supporting basic arithmetic operations and error protection mechanisms.

Calculator MCP Server 🧮

PyPI version License Python Version

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

功能特性

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

安装方式

pip install mcp-calculate-server

快速使用

{
  "mcpServers": {
    "calculate_mcp": {
      "command": "uvx",
      "args": ["mcp_calculate_server"]
      }
    }
  }

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 接口文档
- 支持的操作符表格
- 错误码说明
- 安装和开发信息
- 开源协议和贡献指引