claude-code-mcp

An MCP server that wraps claude mcp serve and transforms response formats for Kiro Powers compatibility.

Problem

Claude CLI's MCP server returns responses with outputSchema, but the actual content format doesn't match what Kiro expects as structured content. This causes most tools to fail with:

Tool XXX has an output schema but did not return structured content

Solution

This proxy intercepts Claude CLI responses and removes outputSchema definitions, allowing Kiro to accept responses in any format.

Prerequisites

1. Claude CLI - Must be installed and in your PATH

   # Verify installation
   which claude
      
   # Login if needed
   claude login

2. Node.js 16+

Installation

Via npx (Recommended)

No installation needed. Configure directly in your MCP settings.

Manual Installation

git clone <repo-url>
cd claude-code-mcp
npm install

Configuration

Add to ~/.kiro/settings/mcp.json or .kiro/settings/mcp.json:

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "claude-code-mcp@latest"]
    }
  }
}

Custom Claude Path

If Claude CLI is not in your PATH:

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "claude-code-mcp@latest"],
      "env": {
        "CLAUDE_PATH": "/path/to/claude"
      }
    }
  }
}

Available Tools

Through this proxy, you get access to all Claude Code tools:

• Bash - Execute shell commands
• Read - Read file contents
• Write - Write files
• Edit - Edit files
• Glob - File pattern matching
• Grep - Search file contents
• Task - Launch autonomous agent for complex tasks
• WebSearch - Web search
• WebFetch - Fetch web content
• TodoWrite - Task list management
• And more...

How It Works

1. Spawns claude mcp serve as a child process
2. Intercepts tools/list responses and removes outputSchema from all tools
3. Transforms tools/call responses to ensure proper content format
4. Forwards all other requests/responses transparently

Troubleshooting

spawn claude ENOENT

Claude CLI not found. Either:

• Install Claude CLI and ensure it's in PATH
• Set CLAUDE_PATH environment variable

Authentication Failed

Run claude login to authenticate.

Tool Call Timeout

Some operations take longer. For complex tasks, use the Task tool to delegate to a background agent.

License

MIT