Math MCP Learning

Servidor MCP educativo con operaciones matemáticas, estadísticas, visualizaciones y espacio de trabajo persistente.

Documentación

math-mcp-learning-server

Servidor MCP educativo con 17 herramientas, espacio de trabajo persistente y alojamiento en la nube. Construido con FastMCP y el SDK oficial de Python para Model Context Protocol.

Disponible en el Registro MCP (io.github.clouatre-labs/math-mcp-learning-server) y en PyPI.

Demo

$math-mcp Demo$

Consulta CONTRIBUTING.md para obtener instrucciones sobre cómo grabar tu propia demo.

Inicio rápido

Nube (sin instalación)

Conecta tu cliente MCP al servidor alojado:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "math-cloud": {
      "transport": "http",
      "url": "https://math-mcp.fastmcp.app/mcp"
    }
  }
}

Instalación local

{
  "mcpServers": {
    "math": {
      "command": "uvx",
      "args": ["math-mcp-learning-server[scientific,plotting]"]
    }
  }
}

Para otras opciones de instalación (básica, solo científica, solo gráficos), consulta CONTRIBUTING.md.

Herramientas

Categoría	Herramienta	Descripción
Espacio de trabajo	`workspace_save`	Guarda cálculos en almacenamiento persistente
	`workspace_load`	Recupera cálculos previamente guardados
Matemáticas	`calc_expression`	Evalúa expresiones matemáticas de forma segura
	`calc_statistics`	Análisis estadístico (media, mediana, moda, desviación estándar, varianza)
	`calc_interest`	Calcula interés compuesto para inversiones
	`calc_units`	Convierte entre unidades (longitud, peso, temperatura)
Matrices	`matrix_multiply`	Multiplica dos matrices
	`matrix_transpose`	Transpone una matriz
	`matrix_determinant`	Calcula el determinante de una matriz
	`matrix_inverse`	Calcula la inversa de una matriz
	`matrix_eigenvalues`	Calcula valores propios
Visualización	`plot_function`	Grafica funciones matemáticas
	`plot_histogram`	Crea histogramas estadísticos
	`plot_line_chart`	Crea gráficos de líneas
	`plot_scatter`	Crea diagramas de dispersión
	`plot_box_plot`	Crea diagramas de caja
	`plot_financial_line`	Crea gráficos financieros de líneas

Recursos

math://workspace - Resumen del espacio de trabajo de cálculo persistente
math://history - Historial de cálculos cronológico
math://functions - Referencia de funciones matemáticas disponibles
math://constants/{constant} - Constantes matemáticas (pi, e, proporción áurea, etc.)
math://catalog/tools - Catálogo de herramientas con metadatos y ejemplos de uso
math://variables - Variables activas en el espacio de trabajo actual
math://test - Verificación de estado del servidor

Prompts

math_tutor - Prompts de tutoría estructurados (dificultad configurable)
formula_explainer - Explicación de fórmulas con desgloses paso a paso

Consulta Ejemplos de uso para ver ejemplos detallados.

Desarrollo

Consulta CONTRIBUTING.md para la configuración de desarrollo, pruebas y pautas de contribución.

Seguridad

OpenSSF Best Practices Silver - Menos del 1% de los proyectos de código abierto alcanzan este nivel
REUSE/SPDX - Cumplimiento de licencias para todos los archivos
Commits firmados - Se requieren commits firmados con GPG
Escaneo de dependencias - Actualizaciones automáticas mediante Renovate
Escaneo de CVEs con pip-audit - Verificaciones automáticas de vulnerabilidades de dependencias
Escaneo de secretos con gitleaks - Detecta secretos en código e historial
Seguridad de GitHub Actions con zizmor - Escaneo de seguridad de flujos de trabajo
Cumplimiento de commitlint - Validación de commits convencionales en CI
OpenSSF Scorecard - Evaluación continua de seguridad de código abierto

seguridad de calc_expression

La herramienta calc_expression utiliza eval() restringido con una lista blanca de caracteres y funciones permitidos, ámbito global restringido (solo el módulo math y abs), y sin acceso a funciones integradas peligrosas ni importaciones. Todas las entradas de las herramientas se validan con modelos Pydantic. Las operaciones de archivos están restringidas al directorio designado del espacio de trabajo. Se aplican anotaciones de tipo completas y validación para todas las operaciones.