René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"MCP server fails to connect in Claude Code despite working correctly from CLI","articleBody":"## Description\n\nXcodeBuildMCP v2.0.5 fails to connect when used as an MCP server in Claude Code. The server binary works perfectly from the command line (starts on stdio, registers 24 tools + 5 resources), but Claude Code's `/mcp` reconnect consistently fails with \"Failed to reconnect to XcodeBuildMCP.\"\n\n## Environment\n\n- **XcodeBuildMCP version**: 2.0.5 (globally installed via `npm install -g xcodebuildmcp@latest`)\n- **Claude Code version**: 2.1.38\n- **macOS**: Darwin 25.2.0 (arm64, Apple Silicon — MacBook Air M2)\n- **Node.js**: v23.10.0\n- **npm/npx**: 11.5.2\n- **Xcode**: 26.2 (Build 17C52)\n- **Global install path**: `/opt/homebrew/lib/node_modules/xcodebuildmcp/`\n- **Global binary path**: `/opt/homebrew/bin/xcodebuildmcp`\n\n## Steps to Reproduce\n\n1. Install xcodebuildmcp globally: `npm install -g xcodebuildmcp@latest`\n2. Verify the server works from CLI: `xcodebuildmcp mcp` (starts and listens on stdio — works fine)\n3. Configure Claude Code's `~/.claude/mcp.json` with the server (see configs tried below)\n4. Run `/mcp` in Claude Code to reconnect\n5. **Result**: \"Failed to reconnect to XcodeBuildMCP.\"\n\n## Configurations Attempted\n\n### Attempt 1: Hardcoded path to `cli.js`\n```json\n{\n  \"mcpServers\": {\n    \"XcodeBuildMCP\": {\n      \"command\": \"node\",\n      \"args\": [\"/opt/homebrew/lib/node_modules/xcodebuildmcp/build/cli.js\"]\n    }\n  }\n}\n```\n**Result**: Failed — this was from an older install and was missing the `mcp` subcommand required by v2.x.\n\n### Attempt 2: npx with `mcp` subcommand\n```json\n{\n  \"mcpServers\": {\n    \"XcodeBuildMCP\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"xcodebuildmcp@latest\", \"mcp\"]\n    }\n  }\n}\n```\n**Result**: Failed — `npx -y xcodebuildmcp@latest mcp` runs fine in terminal (server starts, v2.0.5), but Claude Code cannot connect.\n\n### Attempt 3: Global binary directly\n```json\n{\n  \"mcpServers\": {\n    \"XcodeBuildMCP\": {\n      \"command\": \"/opt/homebrew/bin/xcodebuildmcp\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n**Result**: Failed — binary works fine from terminal, Claude Code still can't connect.\n\n### Attempt 4: Wrapper shell script (current config)\nCreated `/Users/seanberry/bin/xcodebuildmcp-mcp`:\n```bash\n#!/usr/bin/env bash\nexec /opt/homebrew/bin/xcodebuildmcp mcp\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"XcodeBuildMCP\": {\n      \"command\": \"/Users/seanberry/bin/xcodebuildmcp-mcp\"\n    }\n  }\n}\n```\n**Result**: Failed — same behavior.\n\n## What Works\n\n- Running `xcodebuildmcp mcp` directly in the terminal starts the server correctly on stdio\n- The server registers 24 tools and 5 resources\n- The wrapper script (`exec /opt/homebrew/bin/xcodebuildmcp mcp`) also runs fine from terminal\n\n## What Doesn't Work\n\n- Claude Code's `/mcp` reconnect fails with every configuration above\n- Full Claude Code restarts between config changes were also attempted\n- No error details are provided beyond \"Failed to reconnect to XcodeBuildMCP.\"\n\n## Possible Contributing Factors\n\n- **Working directory path contains spaces and parentheses**: The project is at `~/Library/Mobile Documents/com~apple~CloudDocs/Coding/Tic Tac Shuffle (iOS)/`. This could potentially cause issues with process spawning or path handling.\n- **iCloud Drive path**: The project lives under `Mobile Documents/com~apple~CloudDocs/` which is iCloud Drive — this may have unusual filesystem behavior.\n- **Claude Code MCP client behavior**: It's unclear what exactly Claude Code does when spawning the MCP server process. There may be environment differences (PATH, working directory, shell) compared to running from a terminal.\n\n## Expected Behavior\n\nClaude Code should be able to start the XcodeBuildMCP server process and communicate with it over stdio, the same way it works when running the command manually in a terminal.\n\n## Additional Context\n\nThis may partially be a Claude Code client issue rather than an XcodeBuildMCP issue, but filing here since the failure is specific to this server. Happy to provide any additional logs or debugging output if there's a way to get more verbose error information from either side.","author":{"url":"https://github.com/seanberry","@type":"Person","name":"seanberry"},"datePublished":"2026-02-10T21:41:40.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":10},"url":"https://github.com/210/XcodeBuildMCP/issues/210"}