clouatre-labs/math-mcp-learning-server

MCP Client Requirements & Installation Clarity

This release improves documentation clarity about MCP client requirements and standardizes on uv for modern, safer dependency management.

Key Improvements

Explicit MCP Client Requirements:

• Added dedicated Requirements section in README
• Listed supported MCP clients: Claude Desktop, Claude Code, OpenCode, Amazon Q, Codex CLI, Gemini CLI, and others
• Clear statement: Cannot run standalone - MCP client required
• Fixed misleading "no installation needed" for cloud URL - now says "no local installation needed"

Standardized on uv Installation:

• Replaced all pip install commands with uv pip install throughout documentation
• uv provides safer, more modern dependency management
• Consistent installation patterns across all examples

Better Developer Experience:

• Fixed development section: shows uv run fastmcp dev instead of suggesting standalone usage
• Added "MCP Client Requirement" section to FUTURE_IMPROVEMENTS.md
• Updated all user experience examples to mention MCP client context
• Added reminders to connect MCP client after installation

Why These Changes?

Issue: Documentation wasn't clear that:

1. An MCP client is required to use the server
2. The server cannot run standalone (not a web demo)
3. What MCP clients are supported
4. Cloud deployment still needs an MCP client (just no local install)

Solution: Explicit documentation of requirements with comprehensive MCP client list.

Files Changed

• README.md: Added Requirements section, fixed cloud URL clarity, replaced pip with uv
• FUTURE_IMPROVEMENTS.md: Added MCP client requirement note, replaced pip with uv throughout
• pyproject.toml: Version bump to 0.6.5

Installation

No functional changes - this is purely documentation clarity:

# Install locally with uv (recommended):
uvx math-mcp-learning-server

# With plotting support:
uvx math-mcp-learning-server

# Then connect via MCP client (Claude Desktop, Claude Code, etc.)

Cloud deployment (still available):

• Connect MCP client to: https://math-mcp-learning.fastmcp.app/mcp
• No local installation required (but MCP client still needed)

Testing

✅ All 53 tests pass
✅ No code changes - documentation only

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