Skip to main content
Glama
calc_mcp

calc_mcp

by nocodig

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

add

a + b

{"a": 2, "b": 3}

5.0

subtract

a - b

{"a": 2, "b": 5}

-3.0

multiply

a * b

{"a": -3, "b": 4}

-12.0

divide

a / b

{"a": 7, "b": 2}

3.5

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 0 o -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-mcp

También se puede iniciar mediante la entrada del módulo:

uv run python -m calc_mcp

El 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 -v

Las 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 tools
addA
Read-onlyIdempotent

Add two finite numbers: a + b.

Inputs: a (required), b (required). Returns: result

divideA
Read-onlyIdempotent

Divide a by b: a / b. Operands must be finite and b must not be zero.

Inputs: a (required), b (required). Returns: result

multiplyA
Read-onlyIdempotent

Multiply two finite numbers: a * b.

Inputs: a (required), b (required). Returns: result

subtractA
Read-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

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool maps to a single, distinct arithmetic operation: addition, subtraction, multiplication, or division. There is no overlap or ambiguity between tool purposes.

    Naming Consistency5/5

    All tool names follow the same simple verb-only pattern: add, subtract, multiply, divide. The naming is perfectly consistent and instantly predictable.

    Tool Count5/5

    Four tools is the ideal size for a basic arithmetic calculator server. Each tool covers a fundamental operation without unnecessary bloat.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      Provides basic mathematical operations (addition, subtraction, multiplication, division) through a calculate tool. Supports both stdio and HTTP/SSE transport modes.
      1
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes add, subtract, multiply, and divide tools for performing arithmetic operations over stdio via the Model Context Protocol.
      ISC
    • F
      license
      A
      quality
      C
      maintenance
      Enables 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
      -