Calculator MCP Server (Python)

Un servidor Model Context Protocol (MCP) con muchas funciones para cálculos matemáticos, funciones científicas, conversiones de unidades, métricas financieras y análisis estadístico.

Construido con Python 3.10+, el SDK oficial mcp (FastMCP) y sympy. Soporta modos de transporte stdio (Claude Desktop) y sse (Claude Web / conectores HTTP remotos).

🚀 Características y herramientas expuestas

• evaluate_math_expression: Evalúa expresiones matemáticas personalizadas de forma segura usando SymPy (p. ej. 2 * (3 + 4), sqrt(144) + sin(pi / 2), log(100, 10), 5^3).

• perform_arithmetic: Aritmética básica (add, subtract, multiply, divide) sobre arreglos de números.

• scientific_calculation: Potencias, raíces (sqrt, cbrt), factoriales, logaritmos (log, ln) y funciones trigonométricas (sin, cos, tan).

• convert_unit: Conversiones de unidades físicas (longitud, masa/peso, temperatura, volumen, tiempo).

• financial_calculator: Interés simple, interés compuesto, cálculos de EMI de préstamos y porcentajes.

• calculate_statistics: Estadísticas resumidas (mean, median, mode, variance, stdev, summary).

Related MCP server: MCP Mathematics

📦 Instalación y configuración

1. Instalar dependencias:

   pip install -r requirements.txt
   pip install -e .

2. Ejecutar pruebas unitarias automatizadas:

   pytest

💻 1. Conexión con Claude Desktop (modo stdio)

Tu claude_desktop_config.json se ha creado automáticamente en: C:\Users\ADMIN\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "calculator": {
      "command": "C:\\Users\\ADMIN\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": [
        "-m",
        "calculator_mcp.server"
      ],
      "env": {
        "PYTHONPATH": "E:/mcp tutorials"
      }
    }
  }
}

Uso en Claude Desktop:

1. Cierra y reinicia completamente Claude Desktop.

2. Abre un chat y busca el 🔨 (icono de martillo/herramientas) en la parte inferior derecha de la barra de mensajes.

3. Pregúntale a Claude: "¿Cuánto es sqrt(144) + sin(pi / 2)?" o "Convierte 100 degC a degF".

🌐 2. Conexión con Claude Web y clientes web remotos (modo HTTP SSE)

Para ejecutar Calculator MCP como un servicio web HTTP (para plataformas basadas en web, conectores web o agentes de IA remotos):

1. Iniciar el servidor web SSE:

   python -m calculator_mcp.server --transport sse --port 8000

2. Configuración del cliente web:

   {
     "mcpServers": {
       "calculator-web": {
         "serverUrl": "http://localhost:8000/sse"
       }
     }
   }

3. Túnel público para aplicaciones web remotas (opcional): Si tu cliente web (como Claude Web remoto) está alojado fuera de tu red local, expón el puerto 8000 usando ngrok o localtunnel:

   npx localtunnel --port 8000
   # Or using ngrok:
   ngrok http 8000

   Luego usa la URL pública HTTPS generada: https://<your-subdomain>.loca.lt/sse en la configuración de tu conector Web MCP.

🔍 Pruebas interactivas a través de la interfaz web (MCP Inspector)

Puedes iniciar la interfaz Web Inspector interactiva oficial del Model Context Protocol para probar visualmente todas las herramientas en tu navegador:

mcp dev calculator_mcp/server.py

O mediante Node:

npx @modelcontextprotocol/inspector@0.4.1 python -m calculator_mcp.server