Fix agent-debug-log MCP resource auto-read error

[maatheusgois-dd]

Summary

• Move agent-debug-log from resources/list to resources/templates/list with uriTemplate: xcodebazel://agent-debug-log?path={path}.
• Fixes Cursor (and other MCP clients) auto-reading the bare xcodebazel://agent-debug-log URI and hitting -32000: agent-debug-log resource requires ?path=<absolute-log-path> query parameter.
• resources/read with a full ?path= URI still works unchanged.

Scope

• MCP server/tools
• CLI commands or parsers
• Bazel build/test/discovery
• Simulator workflows
• Physical device workflows
• UI automation, screenshots, video, logs, or deep links
• LLDB debugging
• macOS, tvOS, watchOS, or visionOS workflows
• Swift Package Manager
• Daemon, session defaults, config, doctor, or setup
• Project scaffolding
• Docs, examples, or agent skills
• CI, release, packaging, or dependencies

Validation

• npm run lint
• npm run typecheck
• npm test (includes new resources/templates/list and parameterized resources/read cases in src/mcp/server.test.ts)
• npm run build
• npx vitest --run --coverage
• Manual MCP validation with Cursor or another MCP client
• Manual CLI validation with xcodebazelmcp ...
• Bazel workspace validation against a real Apple target
• Simulator validation
• Physical device validation

Compatibility

• Adds, removes, or renames MCP tools
• Changes CLI flags, command output, exit codes, or streaming behavior
• Changes config files, environment variables, defaults, or profiles
• Changes generated project scaffolding
• Changes package contents, dependencies, Node support, or release behavior
• Requires updates to docs, README, manifests, schemas, or skills
• No compatibility impact

agent-debug-log is no longer returned by resources/list; clients that need it should use resources/templates/list or read with an explicit ?path= query. The bazel_ios_agent_debug_log_read tool is unchanged.

Notes For Reviewers

Root cause: agent-debug-log was advertised as a static resource but requires a path query param. Cursor prefetches listed resources on connect, triggering the error toast.

After merge, restart the MCP server in Cursor to pick up the change.

Made with Cursor

[codecov]

Codecov Report

❌ Patch coverage is 0% with 8 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/mcp/server.ts	0.00%	8 Missing ⚠️

📢 Thoughts on this report? Let us know!