Math MCP Learning

io.github.clouatre-labsPublished by GitHub account clouatre-labsv0.12.5Updated Oct 24, 2026

Educational MCP server with 17 math/stats tools, visualizations, and persistent workspace

VerifiedStreamable HTTPWeb executableData & AnalyticsAI & ML

Overview

AI-generated overview

An educational math server giving an assistant 17 tools for calculations, statistics, matrices, unit conversion, plots, and a persistent workspace.

What you can do
Evaluate expressions, compute statistics, compound interest and unit conversions (length, weight, temperature). Perform matrix operations: multiply, transpose, determinant, inverse and eigenvalues. Generate plots of functions, histograms, line charts, scatter plots, box plots and synthetic financial price lines. Save and load calculations in a persistent workspace, with resources for workspace summary, history, functions, constants and variables. Offer tutoring and formula-explanation prompts.
When to use it
Useful for teaching, homework help, or quick numeric work where an assistant should compute, convert units, do matrix math, or produce charts without external services. The hosted endpoint suits users who want no local install.
Requirements
Either the hosted HTTP endpoint or a local install via uvx from the PyPI package math-mcp-learning-server. Plotting tools require matplotlib, so install the plotting or scientific extras. No authentication, API keys or environment variables are declared.
Before you install
The workspace tools write saved calculations to persistent storage that survives restarts, so avoid saving sensitive data. The financial plot tool generates synthetic data only and is not real market data. Expression evaluation uses a restricted eval with a whitelist, but it is still an evaluator.

Installation

In SourceWeft

  1. Open Math MCP Learning in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.clouatre-labs%2Fmath-mcp-learning-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

math-mcp-learning-server

[PyPI] [Python] [License] [REUSE] [OpenSSF Best Practices]

Educational MCP server with 17 tools, persistent workspace, and cloud hosting. Built with FastMCP and the official Model Context Protocol Python SDK.

Available on the MCP Registry (io.github.clouatre-labs/math-mcp-learning-server) and PyPI.

Demo

[math-mcp Demo]

See CONTRIBUTING.md for instructions to record your own demo.

Quick Start

Cloud (No Installation)

Connect your MCP client to the hosted server:

Claude Desktop (claude_desktop_config.json):

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

Local Installation

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

For other installation options (basic, scientific-only, plotting-only), see CONTRIBUTING.md.

Tools

CategoryToolDescription
Workspaceworkspace_saveSave calculations to persistent storage
workspace_loadRetrieve previously saved calculations
Mathcalc_expressionSafely evaluate mathematical expressions
calc_statisticsStatistical analysis (mean, median, mode, std_dev, variance)
calc_interestCalculate compound interest for investments
calc_unitsConvert between units (length, weight, temperature)
Matrixmatrix_multiplyMultiply two matrices
matrix_transposeTranspose a matrix
matrix_determinantCalculate matrix determinant
matrix_inverseCalculate matrix inverse
matrix_eigenvaluesCalculate eigenvalues
Visualizationplot_functionPlot mathematical functions
plot_histogramCreate statistical histograms
plot_line_chartCreate line charts
plot_scatterCreate scatter plots
plot_box_plotCreate box plots
plot_financial_lineCreate financial line charts

Resources

  • math://workspace - Persistent calculation workspace summary
  • math://history - Chronological calculation history
  • math://functions - Available mathematical functions reference
  • math://constants/{constant} - Mathematical constants (pi, e, golden_ratio, etc.)
  • math://catalog/tools - Tool catalog with metadata and usage examples
  • math://variables - Active variables in the current workspace
  • math://test - Server health check

Prompts

  • math_tutor - Structured tutoring prompts (configurable difficulty)
  • formula_explainer - Formula explanation with step-by-step breakdowns

See Usage Examples for detailed examples.

Development

See CONTRIBUTING.md for development setup, testing, and contribution guidelines.

Security

  • OpenSSF Best Practices Silver - Fewer than 1% of open source projects reach this level
  • REUSE/SPDX - License compliance for all files
  • Signed Commits - GPG-signed commits required
  • Dependency Scanning - Automated updates via Renovate
  • pip-audit CVE Scanning - Automated dependency vulnerability checks
  • gitleaks Secret Scanning - Detects secrets in code and history
  • zizmor GitHub Actions Security - Workflow security scanning
  • commitlint Enforcement - Conventional commit validation in CI
  • OpenSSF Scorecard - Continuous open source security assessment
calc_expression safety

The calc_expression tool uses restricted eval() with a whitelist of allowed characters and functions, restricted global scope (only math module and abs), and no access to dangerous built-ins or imports. All tool inputs are validated with Pydantic models. File operations are restricted to the designated workspace directory. Complete type hints and validation are enforced for all operations.

Documentation

Source: README.md at commit 4ceaf7d

Tools

17

calc_expression

Mathematical Calculator

Safely evaluate mathematical expressions with support for basic operations and math functions. Supported operations: +, -, *, /, **, () Supported functions: sin, cos, tan, log, sqrt, abs, pow

Parametersexpressionrequired

calc_statistics

Statistical Analysis

Perform statistical calculations on a list of numbers. Available operations: mean, median, mode, std_dev, variance

Parametersnumbersrequiredoperationrequired

calc_interest

Compound Interest Calculator

Calculate compound interest for investments. Formula: A = P(1 + r/n)^(nt) Where: - P = principal amount - r = annual interest rate (as decimal) - n = number of times interest compounds per year - t = time in years

Parametersraterequiredtimerequiredprincipalrequiredcompounds_per_year

calc_units

Unit Converter

Convert between different units of measurement. Supported unit types: - length: mm, cm, m, km, in, ft, yd, mi - weight: g, kg, oz, lb - temperature: c, f, k (Celsius, Fahrenheit, Kelvin)

Parametersvaluerequiredto_unitrequiredfrom_unitrequiredunit_typerequired

matrix_multiply

Matrix Multiplication

Multiply two matrices (A × B).

Parametersmatrix_arequiredmatrix_brequired

matrix_transpose

Matrix Transpose

Transpose a matrix (swap rows and columns).

Parametersmatrixrequired

matrix_determinant

Matrix Determinant

Calculate the determinant of a square matrix.

Parametersmatrixrequired

matrix_inverse

Matrix Inverse

Calculate the inverse of a square matrix.

Parametersmatrixrequired

matrix_eigenvalues

Matrix Eigenvalues

Calculate the eigenvalues of a square matrix.

Parametersmatrixrequired

workspace_save

Save Calculation to Workspace

Save calculation to persistent workspace (survives restarts).

Parametersnamerequiredresultrequiredexpressionrequired

workspace_load

Load Variable

Load previously saved calculation result from workspace.

Parametersnamerequired

plot_function

Function Plotter

Generate mathematical function plots (requires matplotlib).

Parametersx_rangerequiredexpressionrequirednum_points

plot_histogram

Statistical Histogram

Create statistical histograms (requires matplotlib).

Parametersbinsdatarequiredtitle

plot_line_chart

Line Chart

Create a line chart from data points (requires matplotlib).

Parameterscolortitlex_datarequiredy_datarequiredx_labely_labelshow_grid

plot_scatter

Scatter Plot

Create a scatter plot from data points (requires matplotlib).

Parameterscolortitlex_datarequiredy_datarequiredx_labely_labelpoint_size

plot_box_plot

Box Plot

Create a box plot for comparing distributions (requires matplotlib).

Parameterscolortitley_labeldata_groupsrequiredgroup_labels

plot_financial_line

Financial Line Chart

Generate and plot synthetic financial price data (requires matplotlib). Creates realistic price movement patterns for educational purposes. Does not use real market data.

Parametersdayscolortrendstart_price

Version history

1
  1. v0.12.5LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.