Calculator MCP
一个简单而强大的计算器 MCP 服务器，通过 Model Context Protocol 提供数学运算功能。
功能特性
- ➕ 基本运算: 加、减、乘、除、幂、取模
- 🔢 高级数学: 平方根、阶乘、对数
- 📐 三角函数: sin、cos、tan
- 🚀 零依赖: 仅使用 Python 标准库
- 📡 stdio 模式: 兼容 supergateway 和 Claude Desktop
快速开始
使用 uvx (推荐)
uvx bachai-calculator-mcp
使用 pip 安装
pip install bachai-calculator-mcp
bachai-calculator-mcp
直接运行
python main.py
MCP 工具列表
1. calculate
基本数学运算
参数:
operation: 运算类型（add, subtract, multiply, divide, power, modulo）a: 第一个数字b: 第二个数字
示例:
{
"name": "calculate",
"arguments": {
"operation": "add",
"a": 10,
"b": 5
}
}
返回: 10 + 5 = 15
2. sqrt
计算平方根
参数:
number: 要计算平方根的数字
示例:
{
"name": "sqrt",
"arguments": {
"number": 16
}
}
返回: √16 = 4.0
3. factorial
计算阶乘
参数:
number: 要计算阶乘的整数
示例:
{
"name": "factorial",
"arguments": {
"number": 5
}
}
返回: 5! = 120
4. trigonometry
三角函数计算
参数:
function: 三角函数类型（sin, cos, tan）angle: 角度（度数）
示例:
{
"name": "trigonometry",
"arguments": {
"function": "sin",
"angle": 30
}
}
返回: sin(30°) = 0.5
5. logarithm
对数计算
参数:
number: 真数base: 底数（可选，默认为 e）
示例:
{
"name": "logarithm",
"arguments": {
"number": 100,
"base": 10
}
}
返回: log_10(100) = 2.0
配置
Supergateway 配置
{
"mcpServers": {
"calculator": {
"outputTransport": "sse",
"port": 8000,
"stdio": "uvx bachai-calculator-mcp",
"ssePath": "/sse",
"messagePath": "/message"
}
}
}
Claude Desktop 配置
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"calculator": {
"command": "uvx",
"args": ["bachai-calculator-mcp"]
}
}
}
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"calculator": {
"command": "uvx",
"args": ["bachai-calculator-mcp"]
}
}
}
使用示例
在 Claude Desktop 中使用
安装并配置后，您可以向 Claude 发送类似的请求：
- "请帮我计算 123 + 456"
- "计算 25 的平方根"
- "5 的阶乘是多少？"
- "计算 sin(45度)"
- "计算以 2 为底 8 的对数"
手动测试
# 测试初始化
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | uvx bachai-calculator-mcp
# 测试加法
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"calculate","arguments":{"operation":"add","a":10,"b":5}}}' | uvx bachai-calculator-mcp
技术特点
- 零依赖: 仅使用 Python 标准库（math, operator, json）
- 轻量级: 代码简洁，启动快速
- 可靠: 完整的错误处理和边界检查
- 兼容性: 支持 Python 3.7+
- 标准化: 完全遵循 MCP 协议规范
错误处理
服务器包含完善的错误处理：
- ✅ 除零检查
- ✅ 负数平方根检查
- ✅ 阶乘范围验证
- ✅ 对数参数验证
- ✅ JSON 解析错误处理
开发
# 克隆仓库
git clone https://github.com/BACH-AI-Tools/calculator-mcp.git
cd calculator-mcp
# 本地测试
python main.py
# 构建包
python -m build
# 发布到 PyPI
python -m twine upload dist/*
许可证
MIT License - 详见 LICENSE 文件
贡献
欢迎提交 Issue 和 Pull Request！
更新日志
v1.0.0 (2024-11-07)
- 🎉 初始发布
- ✨ 支持基本数学运算
- ✨ 支持高级数学函数
- ✨ 支持三角函数
- ✨ 零依赖实现