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
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 summarymath://history- Chronological calculation historymath://functions- Available mathematical functions referencemath://constants/{constant}- Mathematical constants (pi, e, golden_ratio, etc.)math://catalog/tools- Tool catalog with metadata and usage examplesmath://variables- Active variables in the current workspacemath://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
1 maintainer
Release files for math-mcp-learning-server 0.12.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| math_mcp_learning_server-0.12.5.tar.gz | 62.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| math_mcp_learning_server-0.12.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 105.8 kB
Release files / math_mcp_learning_server-0.12.5.tar.gz
| Download URL | math_mcp_learning_server-0.12.5.tar.gz |
|---|---|
| Size | 62.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
789982208e079f231865b13d82f08a6dc403329cf3dba64bff301c7246bb7d7d
|
|
BLAKE2b-256 checksum How to use checksums |
d50afb6288c3399a6706de44930e0d7d6bdb0c8e1c7d31d5d77bf02f905862a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 1, 2026.
Transparency logRelease files / math_mcp_learning_server-0.12.5-py3-none-any.whl
| Download URL | math_mcp_learning_server-0.12.5-py3-none-any.whl |
|---|---|
| Size | 43.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0a7902cc9f349e4b9e1d0d3639451dafdbaec283f7994101a83baf32b4578ff9
|
|
BLAKE2b-256 checksum How to use checksums |
41bc303d51b1cc59578d687c467753333621d5df70d9a48d5f1e46232c553ec9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 1, 2026.
Transparency log
