macOS Tray App development (native/macos/)

Building the Tray App

cd native/macos/MCPProxy
SDK=$(xcrun --sdk macosx --show-sdk-path)
swiftc -target arm64-apple-macosx13.0 -sdk "$SDK" -module-name MCPProxy -emit-executable -O \
  -o /tmp/MCPProxy-new \
  $(find MCPProxy -name "*.swift" -not -path "*/Tests/*" | sort | tr '\n' ' ')
# Replace in .app bundle:
cp /tmp/MCPProxy-new /tmp/MCPProxy.app/Contents/MacOS/MCPProxy

Building the UI Test Tool

cd native/macos/MCPProxyUITest
SDK=$(xcrun --sdk macosx --show-sdk-path)
swiftc -target arm64-apple-macosx13.0 -sdk "$SDK" -O -o /tmp/mcpproxy-ui-test Sources/main.swift

Testing with mcpproxy-ui-test (MCP Server)

The mcpproxy-ui-test MCP server provides 7 tools for automated UI verification:

Tool	Description
check_accessibility	Verify Accessibility API permissions
list_running_apps	List running macOS apps with bundle IDs
list_menu_items	Read status bar menu tree
click_menu_item	Click menu items by path
read_status_bar	Read status bar item info
screenshot_window	Capture app window or full screen (CGWindowListCreateImage)
screenshot_status_bar_menu	Open tray menu, capture screenshot, close menu

After every macOS tray code change, verify by:

1. Build the tray binary (see above)
2. Replace in /tmp/MCPProxy.app/Contents/MacOS/MCPProxy and restart
3. Use screenshot_window to capture the window and visually verify
4. Use click_menu_item + list_menu_items to verify tray menu behavior
5. Use screenshot_status_bar_menu for tray menu visual verification

MCP config (in Claude Code settings or ~/.claude/settings.json):

{
  "mcpServers": {
    "mcpproxy-ui-test": {
      "command": "/tmp/mcpproxy-ui-test",
      "args": ["--bundle-id", "com.smartmcpproxy.mcpproxy.dev"]
    }
  }
}