Skip to content

Conversation

@DmitryKatson
Copy link
Contributor

Fix macOS/Linux Compatibility Issues in Python MCP Proxy

Problem

The Python MCP Proxy had compatibility issues on macOS and Linux:

  • README showed python command which doesn't exist on macOS/Linux (should be python3)
  • Generated MCP configs didn't use platform-aware Python commands
  • Missing troubleshooting guidance for PATH warnings and version updates

Solution

  • Updated README with platform-specific commands (Windows uses python, macOS/Linux use python3)
  • Fixed setup_flow.py to use sys.executable with platform-aware fallback for generated configs
  • Added troubleshooting notes for PATH warnings and forcing version updates
  • Updated maintainer scripts and documentation

Testing

  • Tested on macOS: python3 -m pip install --upgrade bc-mcp-proxy && python3 -m bc_mcp_proxy setup works correctly
  • Generated MCP configs now use the correct Python interpreter path
  • Verified cross-platform compatibility

Changes

  • samples/BcMCPProxyPython/README.md - Added platform-specific commands and troubleshooting
  • samples/BcMCPProxyPython/bc_mcp_proxy/setup_flow.py - Platform-aware Python command detection
  • samples/BcMCPProxyPython/maintainer/PUBLISHING.md - Updated documentation
  • samples/BcMCPProxyPython/maintainer/scripts/publish.ps1 - Script updates
  • samples/BcMCPProxyPython/maintainer/scripts/publish.sh - Script updates
  • samples/BcMCPProxyPython/pyproject.toml - Version bump (if applicable)

Related

Fixes issues reported by macOS users who couldn't run the setup command due to python vs python3 command differences.

- Update README with platform-specific commands (python3 for macOS/Linux)
- Fix setup_flow.py to use platform-aware Python commands in generated configs
- Add troubleshooting notes for PATH warnings and version updates
- Update maintainer scripts and documentation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant