{
  "markdown": "<!-- mcp-name: io.github.clouatre-labs/math-mcp-learning-server -->\n\n# math-mcp-learning-server\n\n[![PyPI](https://img.shields.io/pypi/v/math-mcp-learning-server?style=for-the-badge&color=3b82f6)](https://pypi.org/project/math-mcp-learning-server/)\n[![Python](https://img.shields.io/pypi/pyversions/math-mcp-learning-server?style=for-the-badge)](https://pypi.org/project/math-mcp-learning-server/)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg?style=for-the-badge)](LICENSE)\n[![REUSE](https://img.shields.io/reuse/compliance/github.com/clouatre-labs/math-mcp-learning-server?style=for-the-badge)](https://api.reuse.software/info/github.com/clouatre-labs/math-mcp-learning-server)\n[![OpenSSF Best Practices](https://img.shields.io/cii/level/12334?style=for-the-badge)](https://www.bestpractices.dev/projects/12334)\n\n**Educational 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).\n\nAvailable on the [MCP Registry](https://registry.modelcontextprotocol.io/) (`io.github.clouatre-labs/math-mcp-learning-server`) and [PyPI](https://pypi.org/project/math-mcp-learning-server/).\n\n## Demo\n\n![math-mcp Demo](https://raw.githubusercontent.com/clouatre-labs/math-mcp-learning-server/main/assets/demo.gif)\n\nSee [CONTRIBUTING.md](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/CONTRIBUTING.md#demo-gif) for instructions to record your own demo.\n\n## Quick Start\n\n### Cloud (No Installation)\n\nConnect your MCP client to the hosted server:\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"math-cloud\": {\n      \"transport\": \"http\",\n      \"url\": \"https://math-mcp.fastmcp.app/mcp\"\n    }\n  }\n}\n```\n\n### Local Installation\n\n```json\n{\n  \"mcpServers\": {\n    \"math\": {\n      \"command\": \"uvx\",\n      \"args\": [\"math-mcp-learning-server[scientific,plotting]\"]\n    }\n  }\n}\n```\n\nFor other installation options (basic, scientific-only, plotting-only), see [CONTRIBUTING.md](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/CONTRIBUTING.md).\n\n## Tools\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| **Workspace** | `workspace_save` | Save calculations to persistent storage |\n| | `workspace_load` | Retrieve previously saved calculations |\n| **Math** | `calc_expression` | Safely evaluate mathematical expressions |\n| | `calc_statistics` | Statistical analysis (mean, median, mode, std_dev, variance) |\n| | `calc_interest` | Calculate compound interest for investments |\n| | `calc_units` | Convert between units (length, weight, temperature) |\n| **Matrix** | `matrix_multiply` | Multiply two matrices |\n| | `matrix_transpose` | Transpose a matrix |\n| | `matrix_determinant` | Calculate matrix determinant |\n| | `matrix_inverse` | Calculate matrix inverse |\n| | `matrix_eigenvalues` | Calculate eigenvalues |\n| **Visualization** | `plot_function` | Plot mathematical functions |\n| | `plot_histogram` | Create statistical histograms |\n| | `plot_line_chart` | Create line charts |\n| | `plot_scatter` | Create scatter plots |\n| | `plot_box_plot` | Create box plots |\n| | `plot_financial_line` | Create financial line charts |\n\n## Resources\n\n- `math://workspace` - Persistent calculation workspace summary\n- `math://history` - Chronological calculation history\n- `math://functions` - Available mathematical functions reference\n- `math://constants/{constant}` - Mathematical constants (pi, e, golden_ratio, etc.)\n- `math://catalog/tools` - Tool catalog with metadata and usage examples\n- `math://variables` - Active variables in the current workspace\n- `math://test` - Server health check\n\n## Prompts\n\n- `math_tutor` - Structured tutoring prompts (configurable difficulty)\n- `formula_explainer` - Formula explanation with step-by-step breakdowns\n\nSee [Usage Examples](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/docs/EXAMPLES.md) for detailed examples.\n\n## Development\n\nSee [CONTRIBUTING.md](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/CONTRIBUTING.md) for development setup, testing, and contribution guidelines.\n\n## Security\n\n- **OpenSSF Best Practices Silver** - Fewer than 1% of open source projects reach this level\n- **REUSE/SPDX** - License compliance for all files\n- **Signed Commits** - GPG-signed commits required\n- **Dependency Scanning** - Automated updates via Renovate\n- **pip-audit CVE Scanning** - Automated dependency vulnerability checks\n- **gitleaks Secret Scanning** - Detects secrets in code and history\n- **zizmor GitHub Actions Security** - Workflow security scanning\n- **commitlint Enforcement** - Conventional commit validation in CI\n- **OpenSSF Scorecard** - Continuous open source security assessment\n\n<!-- markdownlint-disable MD033 -->\n<details>\n<summary><strong>calc_expression safety</strong></summary>\n\nThe `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.\n\n</details>\n<!-- markdownlint-enable MD033 -->\n\n## Documentation\n\n- [Architecture](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/docs/ARCHITECTURE.md)\n- [Cloud Deployment Guide](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/docs/CLOUD_DEPLOYMENT.md)\n- [Usage Examples](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/docs/EXAMPLES.md)\n- [Contributing Guidelines](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/CONTRIBUTING.md)\n- [Maintainer Guide](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/.github/MAINTAINER_GUIDE.md)\n- [Roadmap](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/ROADMAP.md)\n- [Code of Conduct](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/CODE_OF_CONDUCT.md)\n- [License](https://github.com/clouatre-labs/math-mcp-learning-server/blob/main/LICENSE)\n",
  "bytes": 6260,
  "sha": "76ccfa26f3cd6fdb9efa7d0da5a77bbe05f17582954fb46aae17f30a4b5d4de8",
  "repo_slug": "clouatre-labs/math-mcp-learning-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_clouatre_labs_math_mcp_learnin_de8b93bd/readme"
}