clouatre-labs/math-mcp-learning-server

🐛 Critical Bug Fix

• Function Parameter Support: Fixed critical issue where multi-parameter functions like pow(2, 3) were rejected
• Root Cause: Missing comma in allowed_chars validation set
• Impact: All multi-parameter mathematical functions now work correctly

✨ Enhanced User Experience

• Better Error Messages: Specific validation with helpful examples
  • Before: Generic "invalid characters" error
  • After: "Function 'pow()' requires two parameters: pow(base, exponent). Example: pow(2, 3)"
• Function Discovery: New math://functions resource provides comprehensive function documentation
• Educational Value: Clear syntax help and common usage patterns

🔧 What's Working Now

• ✅ pow(2, 3) = 8.0
• ✅ sqrt(16) = 4.0
• ✅ sin(3.14159/2) ≈ 1.0
• ✅ All single-parameter functions (sin, cos, tan, log, sqrt, abs)
• ✅ Enhanced error messages with examples for common mistakes
• ✅ Comprehensive function reference via math://functions resource

🛡️ Security & Quality

• All existing security measures preserved
• FastMCP 2.0 compliance maintained (95%+)
• Backward compatibility for all existing functionality
• Thread-safe persistent workspace unchanged

📦 Installation

pip install math-mcp-learning-server==0.3.1
# or with uv
uv add math-mcp-learning-server==0.3.1

Essential bugfix release - recommended for all users.