clouatre-labs/math-mcp-learning-server

Modular Architecture and Secure Releases

This release restructures the monolithic server into modular sub-servers, adds progress reporting across all 17 tools, and establishes a secure signed release pipeline.

Highlights

• Modular architecture: Extracted tools and resources into dedicated sub-servers (arithmetic, statistics, matrix, visualization, workspace), with shared modules for evaluation, settings, and decorators.
• Progress reporting: All 17 tools now emit structured progress notifications via a shared decorator.
• Secure releases: GPG-signed tags with build provenance attestation and trusted PyPI publishing.

Installation

# Local (stdio transport)
uvx math-mcp-learning-server

# Remote (streamable HTTP, no install needed)
# https://math-mcp.fastmcp.app/mcp

Breaking Changes

• Python 3.14 minimum: Dropped Python 3.11 support (#183)
• Removed TypedDict returns: Tool functions no longer return TypedDict types (#190)

What's Changed

Features

• Progress reporting: All 17 tools emit structured progress notifications (#175, #176)
• A2A agent card: Added /.well-known/agent.json endpoint (#173)
• Secure release workflow: GPG-signed tags, build provenance attestation, trusted PyPI publishing (#191)
• Aptu workflows: Added issue triage and PR review automation (#186, #187)

Improvements

• Modular sub-servers: Extracted arithmetic, statistics, matrix, visualization, workspace into dedicated sub-servers (#177, #178, #179, #180, #181)
• Shared modules: Extracted eval, settings, and decorators into reusable modules (#182, #183, #184)
• ProcessPoolExecutor: Switched eval to process pool for isolation (#185)
• Settings consolidation: Unified configuration with pydantic-settings (#174)

Fixes

• Regex variable substitution: Fixed word boundary matching in plot expressions (#171)
• Deterministic tests: Fixed flaky test assertions (#188, #190)
• Ruff pinning: Pinned ruff to avoid breaking changes (#169, #170)
• Release workflow: Fixed signature verification, permissions, and job dependencies (#196, #197, #199)

Documentation

• ROADMAP.md: Added project roadmap (#163)
• CONTRIBUTING.md: Updated contributor guide (#164)
• Project hints: Added development hints (#172)

Maintenance

• Python 3.14: Dropped 3.11, aligned CI on 3.14 (#183)
• Coverage floor: Added 80% minimum coverage gate (#189)
• Dependency updates: Digest-pinned dependency updates (#165, #166, #167, #168)
• Renovate automerge: Configured automatic merging for minor/patch updates (#193, #194)

Full Changelog: https://github.com/clouatre-labs/math-mcp-learning-server/compare/v0.10.3...v0.11.0