clouatre-labs/math-mcp-learning-server

MCP Compliance, Protocol Tests, and Server Ergonomics

Hardens MCP compliance across the tool layer, adds protocol-level tests for prompts and resources, and improves server usability with structured instructions, a tools catalog resource, and argument completions.

Installation

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

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

What's Changed

Features

• Improved server instructions: Replace single-line instructions with a structured tool-selection guide covering CALCULATE, MATRIX, VISUALIZE, WORKSPACE, and RESOURCES sections (#260)
• Tools catalog resource: Add math://catalog/tools resource returning a JSON index of all 17 tools with category, readOnly flag, and example call (#260)
• Argument completions: Register MCP completion handler scoped to the math://constants/{constant} resource template (#260)
• math://variables resource: Add lightweight resource returning variable names only, complementing the full workspace resource (#259)

Fixes

• Tool annotations: Correct readOnlyHint, openWorldHint, and idempotentHint on calculate, compound_interest, convert_units, and save_calculation (#258)
• Rate validation: Add rate > 1.0 guard on compound_interest with a helpful decimal hint; ctx.warning before all raise ValueError paths (#258)
• Complex eigenvalue warning: Detect and surface imaginary parts truncated to real in matrix_eigenvalues; add complex_eigenvalues_warning and complex_values fields to result model (#258)
• AppContext removal: Remove dead AppContext dataclass and app_lifespan context manager from server.py; clean up unused imports (#258)
• Workspace response limiting: Cap get_workspace response at 4000 chars with truncation notice; cap math://history variable list at 10 entries (#259)

Tests

• Protocol-level tests: Add 6 tests covering math_tutor and formula_explainer prompts via get_prompt(), and math://functions, math://test, math://constants/pi, math://constants/e resources via read_resource() (#259)

Chores

• License: Switch from MIT to Apache-2.0; update pyproject.toml classifier and README badge (#263, #264)
• Dependencies: Update astral-sh/setup-uv, actions/upload-artifact, actions/download-artifact, actions/attest-build-provenance, taiki-e/create-gh-release-action (#240, #241, #242, #243, #244, #245, #246, #247)

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