clouatre-labs/math-mcp-learning-server

This minor release adds 5 matrix operation tools, demonstrating a complete Test-Driven Development (TDD) workflow across 4 PRs.

New Features

Matrix Operations (requires [scientific] extra)

• matrix_multiply: Multiply two matrices with dimension validation
• matrix_transpose: Transpose a matrix (swap rows and columns)
• matrix_determinant: Calculate determinant of square matrices
• matrix_inverse: Compute matrix inverse with singular matrix detection
• matrix_eigenvalues: Calculate eigenvalues (supports complex numbers)

Installation with matrix support:

uvx --from 'math-mcp-learning-server[scientific]' math-mcp-learning-server

Technical Highlights

• TDD Methodology: Complete RED → GREEN → REFACTOR cycle demonstrated
  • PR #106: Dependencies setup (NumPy as optional extra)
  • PR #108: TDD RED phase (21 test specifications)
  • PR #109: TDD GREEN phase (implementation)
  • PR #110: Documentation phase (comprehensive examples)
• NumPy Integration: Optional [scientific] extra for linear algebra
• DoS Prevention: 100x100 matrix size limit with clear error messages
• Complex Number Support: Proper formatting for eigenvalues (real and imaginary)
• Zero Regressions: All 126 tests passing (21 new + 105 existing)

Documentation

• Updated README with matrix operations section
• Comprehensive examples in EXAMPLES.md (success and error cases)
• ROADMAP updated to mark Phase 4 complete
• Installation instructions for all extras ([scientific], [plotting])

Statistics

• Tools: 12 → 17 (+5 matrix operations)
• Tests: 105 → 126 (+21 comprehensive test cases)
• Code Coverage: Maintained at 100% for new features
• Documentation: +417 lines of examples and guides

Upgrade Notes

New optional dependency:

# Without matrix operations
uvx math-mcp-learning-server

# With matrix operations
uvx --from 'math-mcp-learning-server[scientific]' math-mcp-learning-server

Breaking Changes: None - fully backward compatible

Contributors

• @clouatre - Full implementation, testing, and documentation

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