Math MCP Learning Server

1<!-- mcp-name: io.github.clouatre-labs/math-mcp-learning-server -->
2# Math MCP Learning Server
3 
4[![PyPI version](https://badge.fury.io/py/math-mcp-learning-server.svg)](https://pypi.org/project/math-mcp-learning-server/)
5[![Python](https://img.shields.io/pypi/pyversions/math-mcp-learning-server)](https://pypi.org/project/math-mcp-learning-server/)
6[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
7[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
8 
9Educational MCP server with 17 tools, persistent workspace, and cloud hosting. Built with [FastMCP](https://gofastmcp.com) and the official [Model Context Protocol Python SDK](https://github.com/modelcontextprotocol/python-sdk).
10 
11**Available on:**
12- [Official MCP Registry](https://registry.modelcontextprotocol.io/) - `io.github.clouatre-labs/math-mcp-learning-server`
13- [PyPI](https://pypi.org/project/math-mcp-learning-server/) - `math-mcp-learning-server`
14 
15## Requirements
16 
17Requires an MCP client:
18 
19- **Claude Desktop** - Anthropic's desktop app
20- **Claude Code** - Command-line MCP client
21- **Goose** - Open-source AI agent framework
22- **OpenCode** - Open-source MCP client by SST
23- **Kiro** - AWS's AI assistant
24- **Gemini CLI** - Google's command-line tool
25- Any MCP-compatible client
26 
27## Quick Start
28 
29### Cloud (No Installation)
30 
31Connect your MCP client to the hosted server:
32 
33**Claude Desktop** (`claude_desktop_config.json`):
34```json
35{
36  "mcpServers": {
37    "math-cloud": {
38      "transport": "http",
39      "url": "https://math-mcp.fastmcp.app/mcp"
40    }
41  }
42}
43```
44 
45### Local Installation
46 
47**Automatic with uvx** (recommended):
48 
49```json
50{
51  "mcpServers": {
52    "math": {
53      "command": "uvx",
54      "args": ["math-mcp-learning-server"]
55    }
56  }
57}
58```
59 
60**Manual installation:**
61```bash
62# Basic installation
63uvx math-mcp-learning-server
64 
65# With matrix operations support
66uvx --from 'math-mcp-learning-server[scientific]' math-mcp-learning-server
67 
68# With visualization support
69uvx --from 'math-mcp-learning-server[plotting]' math-mcp-learning-server
70 
71# All features
72uvx --from 'math-mcp-learning-server[scientific,plotting]' math-mcp-learning-server
73```
74 
75## Tools
76 
77| Category | Tool | Description |
78|----------|------|-------------|
79| **Workspace** | `save_calculation` | Save calculations to persistent storage |
80| | `load_variable` | Retrieve previously saved calculations |
81| **Math** | `calculate` | Safely evaluate mathematical expressions |
82| | `statistics` | Statistical analysis (mean, median, mode, std_dev, variance) |
83| | `compound_interest` | Calculate compound interest for investments |
84| | `convert_units` | Convert between units (length, weight, temperature) |
85| **Matrix** | `matrix_multiply` | Multiply two matrices |
86| | `matrix_transpose` | Transpose a matrix |
87| | `matrix_determinant` | Calculate matrix determinant |
88| | `matrix_inverse` | Calculate matrix inverse |
89| | `matrix_eigenvalues` | Calculate eigenvalues |
90| **Visualization** | `plot_function` | Plot mathematical functions |
91| | `create_histogram` | Create statistical histograms |
92| | `plot_line_chart` | Create line charts |
93| | `plot_scatter_chart` | Create scatter plots |
94| | `plot_box_plot` | Create box plots |
95| | `plot_financial_line` | Create financial line charts |
96 
97## Resources
98 
99- `math://workspace` - Persistent calculation workspace summary
100- `math://history` - Chronological calculation history
101- `math://functions` - Available mathematical functions reference
102- `math://constants/{constant}` - Mathematical constants (pi, e, golden_ratio, etc.)
103- `math://test` - Server health check
104 
105## Prompts
106 
107- `math_tutor` - Structured tutoring prompts (configurable difficulty)
108- `formula_explainer` - Formula explanation with step-by-step breakdowns
109 
110See [Usage Examples](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/docs/EXAMPLES.md) for detailed examples.
111 
112## Development
113 
114See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and contribution guidelines.
115 
116## Security
117 
118The `calculate` 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.
119 
120## Links
121 
122- [Architecture](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/docs/ARCHITECTURE.md)
123- [Cloud Deployment Guide](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/docs/CLOUD_DEPLOYMENT.md)
124- [Usage Examples](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/docs/EXAMPLES.md)
125- [Contributing Guidelines](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/CONTRIBUTING.md)
126- [Maintainer Guide](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/.github/MAINTAINER_GUIDE.md)
127- [Roadmap](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/ROADMAP.md)
128- [Code of Conduct](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/CODE_OF_CONDUCT.md)
129- [License](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/LICENSE)
130