calc_mcp
calc_mcp
Servicio MCP de calculadora que ofrece las cuatro operaciones de suma, resta, multiplicación y división a través de stdio.
Utiliza la API FastMCP del MCP Python SDK oficial y limita las dependencias a la versión 1.x para evitar cambios en la interfaz debidos a actualizaciones de versiones principales.
Herramientas disponibles
Todas las herramientas reciben dos parámetros numéricos obligatorios a y b; admiten enteros, decimales y negativos.
Herramienta | Operación | Ejemplo de llamada | Resultado |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
El structuredContent de una llamada correcta es {"result": 数值} y se proporciona contenido de texto compatible. Las herramientas no leen ni escriben archivos ni acceden a la red.
Los errores se devuelven con isError: true en el resultado de la herramienta MCP, sin interrumpir el servicio:
El divisor es
0o-0.0:Cannot divide by zero.El parámetro es NaN o infinito:
Operands must be finite numbers.El resultado se desborda a infinito:
Result exceeds the supported finite number range.Faltan parámetros o se pasa un valor numérico que no se puede analizar: el SDK devuelve un error de validación de parámetros.
Las operaciones usan números de coma flotante de doble precisión de Python, por lo que existen los errores habituales de redondeo de coma flotante; por ejemplo, 0.1 + 0.2 puede devolver 0.30000000000000004. No debe utilizarse en escenarios que requieran cálculo decimal exacto; esta versión no admite evaluación de expresiones.
Related MCP server: My Calculator MCP Server
Estructura de directorios
calc_mcp/
├── pyproject.toml # 项目、依赖和命令行入口
├── uv.lock # 依赖版本锁定
├── README.md
├── .gitignore
├── src/calc_mcp/
│ ├── __init__.py
│ ├── __main__.py # python -m calc_mcp 入口
│ ├── server.py # MCP 实例和 stdio 启动
│ └── tools.py # 四则运算、边界检查和工具注册
└── tests/
└── test_server.py # 算术单元测试和 stdio 集成测试Instalación y arranque
Requiere Python 3.10+ y uv. En el directorio de este proyecto, ejecuta:
uv sync
uv run calc-mcpTambién se puede iniciar mediante la entrada del módulo:
uv run python -m calc_mcpEl servicio se comunica con el cliente MCP a través de la entrada/salida estándar y no ofrece una página web. Es normal que, tras iniciarlo directamente, quede a la espera de mensajes del cliente. No imprimas información de depuración en stdout; los registros deben escribirse en stderr.
Ejemplo de configuración para clientes MCP
Lo siguiente se aplica a clientes que usen el formato de configuración JSON mcpServers; adáptalo según el cliente real:
{
"mcpServers": {
"calc-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/lifang/product/0826/calc_mcp",
"run",
"calc-mcp"
]
}
}
}Si el cliente no encuentra uv, cambia command a la ruta absoluta del ejecutable de uv. Después de mover el proyecto, actualiza la ruta del directorio.
Verificación
uv run python -m unittest discover -s tests -vLas pruebas cubren las cuatro operaciones aritméticas, números negativos, decimales, cero, parámetros no válidos, números no finitos y desbordamiento; además, inician un subproceso real de stdio y comprueban la inicialización de MCP, el descubrimiento de herramientas, la invocación de herramientas y las llamadas normales después de un error.
Ubicación para futuras ampliaciones
Añade definiciones de herramientas en src/calc_mcp/tools.py e incluye las funciones en la lista de registro de register_tools(). create_server() de server.py registra las herramientas de forma unificada.
Available Tools
4 toolsaddARead-onlyIdempotent
Add two finite numbers: a + b.
Inputs: a (required), b (required). Returns: result
divideARead-onlyIdempotent
Divide a by b: a / b. Operands must be finite and b must not be zero.
Inputs: a (required), b (required). Returns: result
multiplyARead-onlyIdempotent
Multiply two finite numbers: a * b.
Inputs: a (required), b (required). Returns: result
subtractARead-onlyIdempotent
Subtract b from a: a - b. Both operands must be finite numbers.
Inputs: a (required), b (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool maps to a single, distinct arithmetic operation: addition, subtraction, multiplication, or division. There is no overlap or ambiguity between tool purposes.
All tool names follow the same simple verb-only pattern: add, subtract, multiply, divide. The naming is perfectly consistent and instantly predictable.
Four tools is the ideal size for a basic arithmetic calculator server. Each tool covers a fundamental operation without unnecessary bloat.
The tool set fully covers the core arithmetic operations needed for a calculator: addition, subtraction, multiplication, and division, with appropriate edge-case handling for division by zero. It is a complete minimal surface for its stated purpose.
Maintenance
Related MCP Connectors
Evaluates Reverse Polish Notation (postfix) expressions: arithmetic, trig, logs, bitwise ops.
High-precision finance & business calculations for AI agents — exact decimals, never floats.
Exact arithmetic, algebra, calculus, physics, chemistry and finance with a checkable formula.
Create friendly greetings and add two numbers instantly. Speed up simple tasks and streamline ligh…
Related MCP Servers
- AlicenseDqualityDmaintenanceProvides basic mathematical operations (addition, subtraction, multiplication, division) through a calculate tool. Supports both stdio and HTTP/SSE transport modes.1ISC
- FlicenseNot gradedqualityDmaintenanceEnables basic calculator operations such as add, subtract, multiply, and divide through an MCP interface.-
- AlicenseNot gradedqualityDmaintenanceExposes add, subtract, multiply, and divide tools for performing arithmetic operations over stdio via the Model Context Protocol.ISC
- FlicenseAqualityCmaintenanceEnables an LLM client to perform basic arithmetic on two numbers — addition, subtraction, multiplication, and division — plus reverse a supplied text string, through five simple tools exposed over stdio. Inputs and structured text results follow JSON schemas, with invalid operations such as division by zero surfaced as tool errors.5-