Mcp Calculate Server
What is Mcp Calculate Server
mcp_calculate_server is a secure expression calculator MCP service based on Python AST, designed to perform basic mathematical operations while ensuring error protection mechanisms.
Use cases
Use cases for mcp_calculate_server include building a web-based calculator, integrating calculation features into mobile applications, and providing a secure API for third-party applications to perform mathematical computations.
How to use
To use mcp_calculate_server, install it via pip with the command pip install mcp-calculate-server. Then, import the FastMCP class and start the calculator service by calling calculator.run(transport='stdio').
Key features
Key features include support for basic arithmetic operations (addition, subtraction, multiplication, division), handling of positive and negative signs, automatic formatting of results to two decimal places, and security protections against code injection, division by zero errors, syntax errors, and type safety checks.
Where to use
mcp_calculate_server can be used in various fields such as educational tools for teaching mathematics, backend services for applications requiring calculation capabilities, and any software needing secure mathematical expression evaluation.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Calculate Server
mcp_calculate_server is a secure expression calculator MCP service based on Python AST, designed to perform basic mathematical operations while ensuring error protection mechanisms.
Use cases
Use cases for mcp_calculate_server include building a web-based calculator, integrating calculation features into mobile applications, and providing a secure API for third-party applications to perform mathematical computations.
How to use
To use mcp_calculate_server, install it via pip with the command pip install mcp-calculate-server. Then, import the FastMCP class and start the calculator service by calling calculator.run(transport='stdio').
Key features
Key features include support for basic arithmetic operations (addition, subtraction, multiplication, division), handling of positive and negative signs, automatic formatting of results to two decimal places, and security protections against code injection, division by zero errors, syntax errors, and type safety checks.
Where to use
mcp_calculate_server can be used in various fields such as educational tools for teaching mathematics, backend services for applications requiring calculation capabilities, and any software needing secure mathematical expression evaluation.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Calculator MCP Server 🧮
基于 Python AST 的安全表达式计算器 MCP 服务，支持基础数学运算和错误防护机制。
功能特性
- ✅ 支持加减乘除四则运算（
+,-,*,/） - ✅ 支持正负号处理（
+5,-3） - ✅ 自动格式化计算结果（保留两位小数）
- ⚠️ 安全防护：
- 拦截代码注入风险（通过 AST 解析而非
eval） - 除零错误防护
- 语法错误提示
- 类型安全检查
- 拦截代码注入风险（通过 AST 解析而非
安装方式
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 接口文档 - 支持的操作符表格 - 错误码说明 - 安装和开发信息 - 开源协议和贡献指引
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
