Summary

Fixes critical P1 issue identified by Codex: MCP server must change working directory to OSIRIS_HOME to properly load project configuration.

Problem (Codex P1 Review)

The new client config now launches the server directly via python -m osiris.cli.mcp_entrypoint --base-path <path> without changing into <path>. Most runtime configuration loaders inside the server still look for osiris.yaml relative to Path.cwd(). When Claude or any MCP client executes this command from its own working directory (e.g. the app's config directory), the server will never read the project's osiris.yaml and will run with default paths and no connection definitions, breaking real projects.

Root cause:

• MCP clients launch server from their own CWD (e.g., ~/Library/Application Support/Claude)
• Config loaders search for osiris.yaml relative to Path.cwd()
• Server ran with defaults, missing project config and connections

Solution

Added os.chdir(osiris_home) in setup_environment() after resolving OSIRIS_HOME:

# Create OSIRIS_HOME if it doesn't exist
osiris_home.mkdir(parents=True, exist_ok=True)

# Change working directory to OSIRIS_HOME
# This ensures all relative path lookups (osiris.yaml, osiris_connections.yaml, etc.)
# work correctly when MCP client launches server from a different CWD
os.chdir(osiris_home)

Verification

Tested server startup from different CWD:

# Start from /tmp, but load config from /private/tmp/test-mcp-project
cd /tmp
python -m osiris.cli.mcp_entrypoint --base-path /private/tmp/test-mcp-project --selftest

Results:

INFO: MCP filesystem config loaded from osiris.yaml
INFO:   base_path: /private/tmp/test-mcp-project
INFO:   mcp_logs_dir: /private/tmp/test-mcp-project/.osiris/mcp/logs
✅ All tests PASSED

Config successfully loaded despite running from different directory! ✅

All Changes in This PR

1. ✅ Portable MCP config - Removed bash wrapper, added --base-path parameter
2. ✅ Config-first detection - Loads from osiris.yaml for pip installs
3. ✅ Import ordering - Fixed isort warnings
4. ✅ CWD fix - Server changes to OSIRIS_HOME before loading config (this commit)

Testing

• ✅ Server started from /tmp with --base-path /project
• ✅ Config loaded from correct project directory
• ✅ Selftest passes with proper config values
• ✅ Multiple MCP servers can coexist

Version

v0.5.5

🤖 Generated with Claude Code