Calculator MCP Server

Servidor MCP de Calculadora

Un servidor MCP basado en TypeScript que implementa una calculadora robusta con aritmética decimal precisa. Este servidor demuestra conceptos centrales de MCP al proporcionar operaciones aritméticas con soporte para múltiples operandos y precisión configurable usando Decimal.js.

Características

Herramientas

Funciones Aritméticas

Estas funciones toman un arreglo de al menos dos números y devuelven un único resultado numérico.

• add - Suma un arreglo de números.
• subtract - Resta números secuencialmente desde el primero.
• multiply - Multiplica un arreglo de números.
• divide - Divide números secuencialmente. Maneja la división por cero.

Funciones Trigonométricas

Estas funciones operan sobre arreglos de números y devuelven un arreglo de resultados. La entrada angles requiere al menos un número.

• Trigonometría Básica: sin, cos, tan
  • Entrada: angles (arreglo de números), mode ('radianes' o 'grados', por defecto 'radianes').
• Trigonometría Inversa: asin, acos, atan
  • Entrada: values (arreglo de números).
• Funciones Hiperbólicas: sinh, cosh, tanh
  • Entrada: values (arreglo de números).
• Funciones Hiperbólicas Inversas: asinh, acosh, atanh
  • Entrada: values (arreglo de números).

Misceláneos

• set_precision - Configura la precisión decimal para todos los cálculos posteriores.
  • Toma el parámetro precision como el número de decimales.

Desarrollo

Instala las dependencias:

bun install

Ejecuta el servidor de desarrollo:

bun start

Instalación como servidor MCP independiente

Para usar con Claude Desktop, agrega la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Calculator": {
      "command": "/path/to/calculator-mcp/src/index.ts"
    }
  }
}

O para la extensión Cline VSCode, agrega una versión modificada de esto a tu archivo de configuración MCP:

   "Calculator": {
      "autoApprove": [
        "add",
        "subtract",
        "multiply",
        "divide",
        "set_precision"
      ],
      "disabled": true,
      "timeout": 60,
      "type": "stdio",
      "command": "bun",
      "args": [
        "/path-to-your/calculator-mcp/src/index.ts"
      ]
    }

Instalación usando Docker

Para ejecutar el servidor MCP usando Docker, primero debes construir la imagen usando:

docker build -t calculator-mcp .

Seguido de agregar esto al archivo de configuración MCP (de Cline):

    "Calculator (docker)": {
      "autoApprove": [
        "add",
        "subtract",
        "multiply",
        "divide",
        "set_precision"
      ],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "calculator-mcp"
      ]
    }

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como un script de paquete:

bun run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.