feat(mcp-loader): add timeout and oauth support for Claude Code MCP servers

[cooco119]

Summary

Add support for additional opencode MCP configuration options when loading Claude Code .mcp.json files:

• timeout: Custom timeout in milliseconds for MCP server requests
• oauth: OAuth configuration for remote servers (type definitions only)

Motivation

Long-running MCP operations (e.g., multi-agent arena discussions) were timing out because the transformer wasn't passing through the timeout field from Claude Code's .mcp.json configuration to opencode's MCP config format.

Reference: https://opencode.ai/docs/mcp-servers

Changes

types.ts

• Added timeout?: number to ClaudeCodeMcpServer, McpLocalConfig, and McpRemoteConfig
• Added McpOAuthConfig interface for OAuth configuration
• Added oauth?: McpOAuthConfig | false to McpRemoteConfig

transformer.ts

• Pass through timeout field for both local and remote MCP servers

transformer.test.ts (new)

• Added comprehensive tests for transformer functionality
• Tests cover timeout handling for both local and remote servers

Testing

bun test src/features/claude-code-mcp-loader/
# 16 pass, 0 fail

Example Usage

In Claude Code's .mcp.json:

{
  "mcpServers": {
    "arena": {
      "command": "npx",
      "args": ["-y", "agent-arena"],
      "timeout": 600000
    }
  }
}

This timeout will now be properly passed through to opencode's MCP configuration.

---

Summary by cubic

Adds timeout support and OAuth type definitions to the Claude Code MCP loader so .mcp.json timeouts pass through to opencode and long-running requests don’t fail.

• New Features
  • Passes through timeout for local (stdio) and remote servers.
  • Adds McpOAuthConfig and optional oauth on remote servers (types only).
  • Adds transformer tests for timeout handling and error cases.

^{Written for commit 4ee2467. Summary will update on new commits.}

[github-actions]

All contributors have signed the CLA. Thank you! ✅
_{Posted by the CLA Assistant Lite bot.}

[cubic-dev-ai]

No issues found across 3 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

[cooco119]

I have read the CLA Document and I hereby sign the CLA