math-mcp-learning-server

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):

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

Local Installation

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

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

Tools

Category	Tool	Description
Workspace	`workspace_save`	Save calculations to persistent storage
	`workspace_load`	Retrieve previously saved calculations
Math	`calc_expression`	Safely evaluate mathematical expressions
	`calc_statistics`	Statistical analysis (mean, median, mode, std_dev, variance)
	`calc_interest`	Calculate compound interest for investments
	`calc_units`	Convert between units (length, weight, temperature)
Matrix	`matrix_multiply`	Multiply two matrices
	`matrix_transpose`	Transpose a matrix
	`matrix_determinant`	Calculate matrix determinant
	`matrix_inverse`	Calculate matrix inverse
	`matrix_eigenvalues`	Calculate eigenvalues
Visualization	`plot_function`	Plot mathematical functions
	`plot_histogram`	Create statistical histograms
	`plot_line_chart`	Create line charts
	`plot_scatter`	Create scatter plots
	`plot_box_plot`	Create box plots
	`plot_financial_line`	Create 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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

math_mcp_learning_server-0.12.3.tar.gz (62.8 kB view details)

Uploaded Aug 2, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

math_mcp_learning_server-0.12.3-py3-none-any.whl (43.3 kB view details)

Uploaded Aug 2, 2026 Python 3

File details

Details for the file math_mcp_learning_server-0.12.3.tar.gz.

File metadata

Download URL: math_mcp_learning_server-0.12.3.tar.gz
Upload date: Aug 2, 2026
Size: 62.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for math_mcp_learning_server-0.12.3.tar.gz
Algorithm	Hash digest
SHA256	`f32ae141b5d9f4c21d7c73747c6f1f18ae50c3c12f8c12fb0bbb4a4d8cce7c53`
MD5	`b4e4e3ae66ca078bfa832b88cb321e04`
BLAKE2b-256	`0aedc4a76d8a1446506781d3becc463c3cdfb6e776722cb4babf07f55abc368a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for math_mcp_learning_server-0.12.3.tar.gz:

Publisher: release.yml on clouatre-labs/math-mcp-learning-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: math_mcp_learning_server-0.12.3.tar.gz
- Subject digest: f32ae141b5d9f4c21d7c73747c6f1f18ae50c3c12f8c12fb0bbb4a4d8cce7c53
- Sigstore transparency entry: 2322956981
- Sigstore integration time: Aug 2, 2026
Source repository:
- Permalink: clouatre-labs/math-mcp-learning-server@965ba61a30d11cfbc6c59c16e43e75395329e57a
- Branch / Tag: refs/tags/v0.12.3
- Owner: https://github.com/clouatre-labs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@965ba61a30d11cfbc6c59c16e43e75395329e57a
- Trigger Event: push

File details

Details for the file math_mcp_learning_server-0.12.3-py3-none-any.whl.

File metadata

Download URL: math_mcp_learning_server-0.12.3-py3-none-any.whl
Upload date: Aug 2, 2026
Size: 43.3 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for math_mcp_learning_server-0.12.3-py3-none-any.whl
Algorithm	Hash digest
SHA256	`7353cfdcc01150489ac48868e714fb54debb6df6cfb0bef878239f8a63e982f8`
MD5	`fbd7b83606863956a17de11d466b806e`
BLAKE2b-256	`3f1d92638f87119bfbf5aa40c19a3b7e6aaea0623d4dd90b048f299d434e8d70`

See more details on using hashes here.

Provenance

The following attestation bundles were made for math_mcp_learning_server-0.12.3-py3-none-any.whl:

Publisher: release.yml on clouatre-labs/math-mcp-learning-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: math_mcp_learning_server-0.12.3-py3-none-any.whl
- Subject digest: 7353cfdcc01150489ac48868e714fb54debb6df6cfb0bef878239f8a63e982f8
- Sigstore transparency entry: 2322957236
- Sigstore integration time: Aug 2, 2026
Source repository:
- Permalink: clouatre-labs/math-mcp-learning-server@965ba61a30d11cfbc6c59c16e43e75395329e57a
- Branch / Tag: refs/tags/v0.12.3
- Owner: https://github.com/clouatre-labs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@965ba61a30d11cfbc6c59c16e43e75395329e57a
- Trigger Event: push

Release history Release notifications | RSS feed

This release

0.12.3

Aug 2, 2026

0.12.2

Jul 27, 2026

0.12.1

Apr 2, 2026

0.12.0

Apr 1, 2026

0.11.5

Mar 30, 2026

0.11.4

Mar 19, 2026

0.11.3

Feb 23, 2026

0.11.2

Feb 19, 2026

0.11.1

Feb 16, 2026

0.11.0

Feb 16, 2026

0.10.3

Dec 16, 2025

0.10.2

Dec 16, 2025

0.10.1

Dec 16, 2025

0.10.0

Dec 13, 2025

0.9.2

Dec 10, 2025

0.9.1

Dec 10, 2025

0.9.0

Dec 6, 2025

0.8.2

Nov 4, 2025

0.8.1

Nov 4, 2025

0.8.0

Oct 4, 2025

0.7.5

Oct 4, 2025

0.7.4

Oct 4, 2025

0.7.3

Oct 4, 2025

0.7.1

Oct 4, 2025

0.7.0

Oct 4, 2025

0.6.7

Oct 4, 2025

0.6.6

Oct 4, 2025

0.6.5

Oct 4, 2025

0.6.4

Oct 4, 2025

0.6.3

Oct 4, 2025

0.6.2

Oct 4, 2025

0.6.1

Oct 4, 2025

0.6.0

Sep 30, 2025

0.5.0

Sep 30, 2025

0.4.0

Sep 30, 2025

0.3.2

Sep 29, 2025

0.3.1

Sep 29, 2025

0.3.0

Sep 29, 2025

0.2.0

Sep 28, 2025

0.1.1

Sep 22, 2025

0.1.0

Sep 22, 2025

math-mcp-learning-server 0.12.3

math-mcp-learning-server

Demo

Quick Start

Cloud (No Installation)

Local Installation

Tools

Resources

Prompts

Development

Security

Documentation

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed