clouatre-labs/math-mcp-learning-server

Overview

Version 0.6.0 transforms the Math MCP Learning Server into a visual learning platform by adding matplotlib-based visualization tools. This release implements Phase 2.1 from the FUTURE_IMPROVEMENTS.md roadmap.

What's New

New Visualization Tools

plot_function

Generate mathematical function plots for visual learning:

• Plot any mathematical expression over a specified range
• Automatic domain error handling (NaN for invalid values)
• Base64-encoded PNG output for MCP compatibility
• Educational annotations for difficulty and topic classification

Example Usage:

{
  "expression": "sin(x)",
  "x_range": [-3.14, 3.14],
  "num_points": 100
}

create_histogram

Statistical data visualization with distribution analysis:

• Create histograms from numerical data
• Automatic statistics calculation (mean, median, std_dev)
• Visual indicators for mean and median
• Comprehensive statistical annotations

Example Usage:

{
  "data": [1, 2, 2, 3, 3, 3, 4, 4, 5],
  "bins": 5,
  "title": "Test Scores Distribution"
}

Key Features

Graceful Degradation

Both visualization tools implement graceful degradation with helpful error messages when matplotlib is not installed.

FastMCP 2.0 Compliance

• Context logging for observability
• Structured output format with educational annotations
• Type-safe implementation
• Tool annotations for MCP metadata

Installation

Standard Installation

uvx math-mcp-learning-server

With Visualization Support

uvx math-mcp-learning-server[plotting]

Development Improvements

Dependency Management

• Migrated from [dependency-groups] to [project.optional-dependencies]
• Follows standard Python packaging patterns
• Optional [plotting] group for matplotlib and numpy

Testing

• 17 new comprehensive tests for visualization tools
• Total test count: 53 tests (100% pass rate)
• Full coverage for functionality, edge cases, and graceful degradation

Code Quality

• Type checking passes with mypy
• Ruff linting passes with no issues
• Complete type hints throughout
• Proper async/await usage

Breaking Changes

None. This release is 100% backward compatible with v0.5.0.

Educational Impact

This release dramatically enhances the learning experience by enabling:

• Visual Learning: See mathematical functions come to life through plots
• Data Understanding: Visualize statistical distributions and patterns
• Interactive Exploration: Experiment with different functions and ranges
• Pattern Recognition: Identify trends through histogram analysis

Links

• PyPI Package: https://pypi.org/project/math-mcp-learning-server/
• Documentation: https://github.com/huguesclouatre/math-mcp-learning-server#readme
• Contributing: https://github.com/huguesclouatre/math-mcp-learning-server/blob/main/CONTRIBUTING.md

Full Changelog: https://github.com/huguesclouatre/math-mcp-learning-server/compare/v0.5.0...v0.6.0