clouatre-labs/math-mcp-learning-server

v0.7.1 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

Published 8mo MCP Developer Tools

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

calculator educational fastmcp fastmcp-3 mathematics mcp

+3 more

mcp-server python tutorial

Summary

AI summary

Fixed deployment failure on FastMCP Cloud by replacing a relative import with an absolute one.

Full changelog

Critical Hotfix

Fixes v0.7.0 deployment failure on FastMCP Cloud.

Bug Fixed

Error: attempted relative import with no known parent package

Root cause: Line 20 in server.py used relative import:

from . import visualization  # ❌ Breaks in FastMCP Cloud

Solution: Changed to absolute import:

from math_mcp import visualization  # ✅ Works everywhere

Why This Happened

FastMCP Cloud loads server.py directly without package context, causing relative imports to fail. Absolute imports work in both packaged usage (tests, local dev) and direct execution (cloud deployment).

Documentation Updated

Added Python import standards to CLAUDE.md:

Always use absolute imports for cloud compatibility
Avoid relative imports (from ., from ..)

Testing

✅ All 67 tests passing
✅ Type checking clean (mypy)
✅ Linting clean (ruff)
✅ Import tested locally

Impact

No breaking changes. Restores cloud deployment functionality for all v0.7.0 visualization features.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track clouatre-labs/math-mcp-learning-server

Get notified when new releases ship.

About clouatre-labs/math-mcp-learning-server

Educational MCP server for math operations, statistics, visualization, and persistent workspaces. Built with FastMCP 2.0.

All releases →