Odoo MCP Unified Server

# Upgrade to Latest FastMCP Versions 🚀 ## Summary This Odoo MCP Unified server now uses **the latest stable versions** of FastMCP and MCP libraries, not the outdated 0.1.0 version. ## What Changed ### Before (Old Approach - Deprecated) ```python # Old way with deprecated parameters mcp = FastMCP( "Server Name", description="...", # ❌ No longer supported dependencies=["..."], # ❌ Moved to config lifespan=app_lifespan, # ❌ Different approach now ) @mcp.tool def my_tool(ctx: Context, param: str): odoo = ctx.request_context.lifespan_context.odoo # ❌ Complex ``` ### After (New Approach - Latest API) ```python # Modern FastMCP API mcp = FastMCP( name="Server Name", # ✅ Simple name parameter instructions="""...""" # ✅ Instructions instead of description ) # Helper function for dependency management def _get_odoo() -> OdooClient: return get_odoo_client() @mcp.tool def my_tool(param: str): # ✅ No ctx needed for simple cases odoo = _get_odoo() # ✅ Clean dependency injection ``` ## Version Changes ### requirements.txt ```diff # Before - mcp>=0.1.1,<2.0.0 - fastmcp==0.1.0 # After + mcp>=1.0.0 # Latest stable + fastmcp>=0.7.0 # Latest stable ``` ### Key Improvements 1. **No More `description` Parameter** - Old: `FastMCP("name", description="...")` - New: `FastMCP(name="name", instructions="...")` 2. **No More `dependencies` Parameter** - Dependencies now managed via `pyproject.toml` or `fastmcp.json` 3. **No More `lifespan` in Constructor** - Lifespan management is now automatic - Use dependency injection patterns instead 4. **Simplified Context Usage** - No need for `ctx.request_context.lifespan_context` - Direct dependency access via helper functions ## Benefits of Latest Versions ### FastMCP >=0.7.0 - ✅ Cleaner, more Pythonic API - ✅ Better performance - ✅ Improved error messages - ✅ Enhanced SSE transport support - ✅ Better dependency management - ✅ More stable and battle-tested ### MCP >=1.0.0 - ✅ Stable v1 API - ✅ Better protocol compliance - ✅ Enhanced features - ✅ Long-term support ## Migration Steps If you have an old Odoo MCP project: ### 1. Update requirements.txt ```bash # Replace old versions mcp>=1.0.0 fastmcp>=0.7.0 ``` ### 2. Update FastMCP initialization ```python # Old mcp = FastMCP("Name", description="...", dependencies=[...], lifespan=...) # New mcp = FastMCP(name="Name", instructions="...") ``` ### 3. Remove lifespan context access ```python # Old odoo = ctx.request_context.lifespan_context.odoo # New odoo = _get_odoo() # Use helper function ``` ### 4. Simplify tool signatures ```python # Old - Complex @mcp.tool def my_tool(ctx: Context, param: str): odoo = ctx.request_context.lifespan_context.odoo ... # New - Simple @mcp.tool def my_tool(param: str): odoo = _get_odoo() ... ``` ### 5. Test thoroughly ```bash cd your-project pip install -r requirements.txt --upgrade python run_server.py ``` ## Compatibility - ✅ Python 3.10+ - ✅ Claude Desktop (stdio transport) - ✅ Zeabur/Railway (SSE transport) - ✅ All existing tools and resources - ✅ All business logic unchanged ## Why Not Lock to Old Versions? ### Problems with Old Approach (fastmcp==0.1.0) - ❌ Using deprecated API - ❌ Missing newer features - ❌ Potential security issues - ❌ No future updates - ❌ Community moving forward ### Benefits of Latest Stable - ✅ Active development - ✅ Bug fixes and improvements - ✅ Security updates - ✅ Community support - ✅ Better documentation ## Testing After upgrading, test these scenarios: ### 1. Basic Connection ```bash # Set environment variables export ODOO_URL=https://your-company.odoo.com export ODOO_DB=your-database export ODOO_USERNAME=your-username export ODOO_PASSWORD=your-password # Run server python run_server.py ``` ### 2. Test execute_method ```python # Should work without ctx execute_method( model="res.partner", method="search_read", args=[], kwargs={"limit": 5} ) ``` ### 3. Test all resources ``` odoo://models odoo://model/res.partner odoo://record/res.partner/1 odoo://search/res.partner/[[]] ``` ## Rollback (If Needed) If you encounter issues: ```bash # Temporarily roll back pip install "mcp>=0.1.1,<2.0.0" "fastmcp==0.1.0" # Then report the issue! ``` But note: The old API will eventually be completely deprecated. ## Support - 📖 [FastMCP Documentation](https://gofastmcp.com) - 📖 [MCP Protocol](https://modelcontextprotocol.io) - 💬 [GitHub Issues](https://github.com/jlowin/fastmcp/issues) ## Conclusion This upgrade ensures your Odoo MCP server uses **modern, stable, and actively maintained** versions of FastMCP and MCP libraries. The changes are minimal but important for long-term maintainability and compatibility. --- **Updated**: 2025-10-15 **Version**: 2.0.0 (Latest Stable)