[Bug]: Diagnostic Tool inaccurately reports configuration

[joshavant]

Bug Description

The diagnostic tool output does not appear to reflect the actual, underlying configuration.

I'm noticing its output is incorrect with respect to my Incremental Builds, Tool Groups, and Sentry settings.

The Claude Code MCP configuration included below is located at ~/.claude.json.

Debug Output

% npx --package xcodebuildmcp@latest xcodebuildmcp-diagnostic
Running XcodeBuildMCP Diagnostic Tool (v1.10.4)...
Collecting system information and checking dependencies...

[2025-06-30T22:51:25.973Z] [INFO] [Diagnostic]: Running diagnostic tool
[2025-06-30T22:51:26.199Z] [DEBUG] xcodemake is not enabled, skipping availability check

XcodeBuildMCP Diagnostic Report

Generated: 2025-06-30T22:51:26.199Z
Server Version: 1.10.4

System Information

• platform: darwin
• release: 24.4.0
• arch: arm64
• cpus: 12 x Apple M3 Pro
• memory: 36 GB
• hostname: Mac.localdomain
• username: joshavant
• homedir: /Users/joshavant
• tmpdir: /var/folders/zd/wvpl48vn1sbbzl18607259v00000gp/T

Node.js Information

• version: v22.16.0
• execPath: /Users/joshavant/.nvm/versions/node/v22.16.0/bin/node
• pid: 51097
• ppid: 51082
• platform: darwin
• arch: arm64
• cwd: /Users/joshavant/Developer/ios
• argv: /Users/joshavant/.nvm/versions/node/v22.16.0/bin/node /Users/joshavant/.npm/_npx/99336612077b7094/node_modules/.bin/xcodebuildmcp-diagnostic

Xcode Information

• version: Xcode 16.2 - Build version 16C5032a
• path: /Applications/Xcode.app/Contents/Developer
• selectedXcode: /Applications/Xcode.app/Contents/Developer/usr/bin/xcodebuild
• xcrunVersion: xcrun version 70.

Dependencies

• axe: ❌ Not found
• xcodemake: ❌ Not found
• mise: ✅ 2025.5.16 macos-arm64 (2025-05-29)

Environment Variables

• XCODEBUILDMCP_DEBUG: true
• INCREMENTAL_BUILDS_ENABLED: (not set)
• DEVELOPER_DIR: (not set)
• HOME: /Users/joshavant
• USER: joshavant
• TMPDIR: /var/folders/zd/wvpl48vn1sbbzl18607259v00000gp/T/
• NODE_ENV: (not set)
• SENTRY_DISABLED: (not set)

PATH

/Users/joshavant/.npm/_npx/99336612077b7094/node_modules/.bin
/Users/joshavant/Developer/ios/node_modules/.bin
/Users/joshavant/Developer/node_modules/.bin
/Users/joshavant/node_modules/.bin
/Users/node_modules/.bin
/node_modules/.bin
/Users/joshavant/.nvm/versions/node/v22.16.0/lib/node_modules/npm/node_modules/@npmcli/run-script/lib/node-gyp-bin
/Users/joshavant/.nvm/versions/node/v22.16.0/bin
/Users/joshavant/.rbenv/shims
/opt/homebrew/bin
/opt/homebrew/sbin
/usr/local/bin
/System/Cryptexes/App/usr/bin
/usr/bin
/bin
/usr/sbin
/sbin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin
/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin
/Library/Apple/usr/bin

Feature Status

UI Automation (axe)

• Available: ✅ Yes
• UI Automation Supported: ✅ Yes

Incremental Builds

• Enabled: ❌ No
• Available: ❌ No
• Makefile exists: ✅ Yes

Mise Integration

• Running under mise: ❌ No
• Mise available: ✅ Yes

Tool Groups Status

• All tool groups are enabled (selective mode is disabled).

Individually Enabled Tools

• All tools are enabled (selective mode is disabled).

Tool Availability Summary

• Build Tools: ✅ Available
• UI Automation Tools: ✅ Available
• Incremental Build Support: ❌ Not available

Sentry

• Sentry enabled: ✅ Yes

Troubleshooting Tips

• If UI automation tools are not available, install axe: brew tap cameroncooke/axe && brew install axe
• If incremental build support is not available, you can download the tool from https://github.com/cameroncooke/xcodemake. Make sure it's executable and available in your PATH
• To enable xcodemake, set environment variable: export INCREMENTAL_BUILDS_ENABLED=1
• For mise integration, follow instructions in the README.md file
• To enable specific tool groups, set the appropriate environment variables (e.g., export XCODEBUILDMCP_GROUP_DISCOVERY=true)
• If you're having issues with environment variables, make sure to use the correct prefix:
  • Use XCODEBUILDMCP_GROUP_NAME=true to enable a tool group
  • Use XCODEBUILDMCP_TOOL_NAME=true to enable an individual tool
  • Common mistake: Using XCODEBUILDMCP_BUILD_IOS_SIM=true instead of XCODEBUILDMCP_GROUP_BUILD_IOS_SIM=true

Diagnostic complete. Please include this output when reporting issues.

Editor/Client

Claude Code

MCP Server Version

xcodebuildmcp@latest (v1.10.4)

LLM

N/A

MCP Configuration

"XcodeBuildMCP": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp@latest"
      ],
      "env": {
        "SENTRY_DISABLED": "true",
        "INCREMENTAL_BUILDS_ENABLED": "true",
        "XCODEBUILDMCP_GROUP_PROJECT_DISCOVERY": "true",
        "XCODEBUILDMCP_GROUP_IOS_SIMULATOR_WORKFLOW": "true"
      }
    }

Steps to Reproduce

1. Configure Claude Code with the included MCP configuration
2. Run npx --package xcodebuildmcp@latest xcodebuildmcp-diagnostic

Expected Behavior

The diagnostic output describes a configuration that DOES match my MCP server configuration.

Actual Behavior

The diagnostic output describes a configuration that DOES NOT match my MCP server configuration:

- INCREMENTAL_BUILDS_ENABLED: (not set)
- SENTRY_DISABLED: (not set)

### Incremental Builds
- Enabled: ❌ No
- Available: ❌ No

(Weird that it says it's not available? Does this refer to xcodemake availability?)

### Tool Groups Status
- All tool groups are enabled (selective mode is disabled).

### Individually Enabled Tools
- All tools are enabled (selective mode is disabled).

- Incremental Build Support: ❌ Not available

- Sentry enabled: ✅ Yes

[cameroncooke]

Thanks for reporting.

This is because when using the diagnostic tool directly you're not using it within the client environment of the MCP running in Claude Code which is where the environmental variables are set.

To get a fully accurate view just ask Claude Code to "run the diagnostic tool" and dump the output. The npx option will provide general system information but it won't necessarily pick up MCP environmental configuration unless either running under the MCP server or the MCP environment variables are defined at a user/system level.

[cameroncooke]

Closing this as completed.