Calculator MCP Server 🧮

Calculator MCP Server 🧮

site icon
2025.05.08 0
Python安全表达式计算器数学运算开发效率
mcp_calculate_server 是一个基于 Python AST 的安全表达式计算器 MCP 服务,支持基础数学运算和错误防护机制。它提供了安全的数学表达式计算功能,包括加减乘除四则运算、正负号处理,并具备自动格式化计算结果的能力。此外,它还提供了安全防护机制,如拦截代码注入风险、除零错误防护、语法错误提示和类型安全检查。
View on GitHub

Overview

基本能力

产品定位

mcp_calculate_server 是一个安全表达式计算器 MCP 服务,主要用于提供安全的数学表达式计算功能。

核心功能

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

适用场景

  • 需要安全计算数学表达式的应用
  • 需要防止代码注入的应用
  • 需要错误防护和提示的应用

工具列表

  • perform_calculation(expression: str) -> str:接收数学表达式字符串,返回格式化结果或错误信息

常见问题解答

  • 错误类型:
  • 语法错误
  • 不支持的运算符
  • 除零错误
  • 非法操作数类型

使用教程

使用依赖

  • Python 3.13+
  • mcp-server 库(自动安装)

安装教程

pip install mcp-calculate-server

调试方式

from mcp.server.fastmcp import FastMCP

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

许可证

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