Vibe Math MCP

Un servidor de alto rendimiento del Protocolo de Contexto de Modelo (MCP) para hacer cálculos matemáticos mientras se vibra con LLMs. Construido con Polars, Pandas, NumPy, SciPy y SymPy para una velocidad de cálculo óptima y capacidades matemáticas integrales, desde aritmética básica hasta cálculo avanzado y álgebra lineal.

GitHub

Prueba este MCPPatrocinado

Documentación

Vibe Math MCP

$PyPI version$ $Python Version$ $Smithery$

Un servidor de Model Context Protocol (MCP) de alto rendimiento para hacer matemáticas mientras se vibra con LLMs. Construido con Polars, Pandas, NumPy, SciPy y SymPy para una velocidad de cálculo óptima y capacidades matemáticas integrales, desde aritmética básica hasta cálculo avanzado y álgebra lineal.

Características

21 herramientas matemáticas en 6 dominios + orquestación por lotes:

Cálculos básicos (4 herramientas): Evaluación de expresiones, porcentajes, redondeo, conversión de unidades
Operaciones con arrays (4 herramientas): Operaciones elemento a elemento, estadísticas, agregaciones, transformaciones
Estadística (3 herramientas): Estadística descriptiva, tablas dinámicas, correlaciones
Matemática financiera (3 herramientas): Valor del dinero en el tiempo, interés compuesto, perpetuidad
Álgebra lineal (3 herramientas): Operaciones con matrices, resolución de sistemas, descomposiciones
Cálculo (3 herramientas): Derivadas, integrales, límites y series
Ejecución por lotes (1 herramienta): Orquestación multiherramienta para flujos de trabajo complejos

Instalación

IDEs

Claude Desktop

Abre Configuración > Desarrollador > Editar configuración y añade:

Para el paquete publicado:

{
  "mcpServers": {
    "Math": {
      "command": "uvx",
      "args": ["vibe-math-mcp"]
    }
  }
}

Para desarrollo local:

{
  "mcpServers": {
    "Math": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/vibe-math-mcp",
        "run",
        "vibe-math-mcp"
      ]
    }
  }
}

Claude Code

Configuración rápida (CLI):

Paquete publicado:

claude mcp add --transport stdio math -- uvx vibe-math-mcp

Desarrollo local:

claude mcp add --transport stdio math -- uvx --from /absolute/path/to/vibe-math-mcp vibe-math-mcp

Configuración de equipo (crea .mcp.json en la raíz del proyecto para uso compartido con Claude Code y/o IDEs)

{
  "mcpServers": {
    "math": {
      "command": "uvx",
      "args": ["vibe-math-mcp"]
    }
  }
}

Verificar: Ejecuta claude mcp list o usa /mcp o consulta los servidores disponibles en los IDEs.

Pruébalo

"Calcula el 15% de 250" → usa percentage
"Encuentra el determinante de [[1,2],[3,4]]" → usa matrix_operations
"Integra x^2 de 0 a 1" → usa integral
"Si invierto $1000 al 5% de interés anual compuesto mensualmente durante 10 años, ¿cuál será el valor futuro?" → usa compound_interest
Si me pagaran la raíz cuadrada de $69 millones en 10 años, ¿cuál es el valor presente con una tasa de descuento del 7%? → usa batch_execute (calculate -> financial_calcs)

Control de salida

Todas las herramientas admiten automáticamente el control de salida para máxima flexibilidad y eficiencia de tokens. El LLM puede especificar el nivel de verbosidad deseado.

Controla la verbosidad de la respuesta usando el parámetro output_mode (disponible en cada herramienta):

Modo	Descripción	Ahorro de tokens	Caso de uso
`full`	Respuesta completa con todos los metadatos (predeterminado)	0% (base)	Depuración, contexto completo necesario
`compact`	Elimina campos nulos, minimiza espacios en blanco	~20-30%	Reducción moderada, conserva la estructura
`minimal`	Solo valores principales, elimina metadatos	~60-70%	Extracción rápida, contexto mínimo
`value`	Estructura `{value: X}` normalizada	~70-80%	Encadenamiento consistente, máxima simplicidad
`final`	Para cadenas secuenciales, devuelve solo el resultado final	~95%	Cálculos simples, extracción predecible

Ejecución por lotes

Para flujos de trabajo de varios pasos, batch_execute encadena múltiples cálculos en una sola solicitud—logrando una reducción de tokens del 90-95%. Referencia salidas anteriores usando la sintaxis $operation_id.result, y el motor maneja automáticamente la resolución de dependencias y la ejecución en paralelo para mayor velocidad.

Perfecto para: Valoración de bonos, modelos financieros, pipelines estadísticos, transformaciones complejas

Referencia completa de herramientas

Nota: Todos los parámetros de las herramientas incluyen descripciones detalladas con ejemplos concretos directamente en la interfaz MCP. Cada parámetro muestra el formato esperado, casos de uso y valores de muestra para que su uso sea obvio sin necesidad de consultar documentación externa.

Cálculos básicos

Herramienta	Descripción
`calculate`	Evalúa expresiones matemáticas con sustitución de variables
`percentage`	Cálculos de porcentaje (de, aumento, disminución, cambio)
`round`	Redondeo avanzado (redondear, piso, techo, truncar)
`convert_units`	Conversiones de unidades (grados radianes)

Operaciones con arrays

Herramienta	Descripción
`array_operations`	Operaciones elemento a elemento (sumar, restar, multiplicar, dividir, potencia)
`array_statistics`	Medidas estadísticas (media, mediana, desviación estándar, mínimo, máximo, suma)
`array_aggregate`	Agregaciones (suma de productos, promedio ponderado, producto punto)
`array_transform`	Transformaciones (normalizar, estandarizar, escalar, log)

Estadística

Herramienta	Descripción
`statistics`	Análisis integral (describir, cuartiles, valores atípicos)
`pivot_table`	Crea tablas dinámicas con agregación
`correlation`	Matrices de correlación (Pearson, Spearman)

Matemática financiera

Herramienta	Descripción
`financial_calcs`	Valor del dinero en el tiempo (VP, VF, PMT, TIR, VAN)
`compound_interest`	Interés compuesto con varias frecuencias

Álgebra lineal

Herramienta	Descripción
`matrix_operations`	Operaciones con matrices (multiplicar, inversa, transponer, determinante, traza)
`solve_linear_system`	Resuelve sistemas Ax = b
`matrix_decomposition`	Descomposiciones (autovalores, SVD, QR, Cholesky, LU)

Cálculo

Herramienta	Descripción
`derivative`	Diferenciación simbólica y numérica
`integral`	Integración simbólica y numérica
`limits_series`	Límites y expansiones en serie


## Development

### Running Tests

```bash
# Install dependencies
uv sync

# Run all tests
uv run poe test

Modos de desarrollo local

Modo STDIO (predeterminado - para Claude Desktop, IDEs):

uv run vibe-math-mcp

Modo HTTP (para pruebas en contenedores):

uv run python -m vibe_math_mcp.http_server

Licencia

Licencia MIT. Consulta el archivo LICENSE para más detalles.

Contribuciones

¡Las contribuciones son bienvenidas mediante PRs! Por favor, asegúrate de:

Que las pruebas pasen y se añadan nuevas si corresponde
Que el código esté lintado y formateado
Que se incluyan anotaciones de tipo
Que se proporcionen mensajes de error claros y accionables

Soporte

Para problemas y preguntas, abre un issue en GitHub.