# MCP Claude Shell Server (Node.js)

A Node.js implementation of an MCP (Model Context Protocol) server that wraps the Claude Code CLI, enabling parallel execution of Claude AI requests.

## Features

- **Parallel Execution**: Multiple requests are processed concurrently using Promise-based async handling
- **Retry Logic**: Automatic retry with configurable attempts and timeouts
- **Model Selection**: Support for Haiku, Sonnet, and Opus models
- **JSON Validation**: Built-in JSON response validation for structured outputs
- **Full Claude CLI Options**: Support for all Claude CLI parameters including system prompts, tool permissions, and more

## Installation

```bash
npm install
npm run build
```

## Usage

### As MCP Server

Add to your Claude Code configuration:

```bash
claude mcp add --transport stdio claude-shell -- node /path/to/mcp-claude-node/dist/index.js
```

Or manually add to `~/.claude.json`:

```json
{
  "mcpServers": {
    "claude-shell": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-claude-node/dist/index.js"]
    }
  }
}
```

### Development

```bash
# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npx tsx test-client.ts
```

## Available Tools

| Tool | Description |
|------|-------------|
| `claude_generate` | Generate code or text with retry and model selection |
| `claude_edit` | Edit files with retry and model selection |
| `claude_refactor` | Refactor code with retry and model selection |
| `claude_generate_json` | Generate JSON response with validation |
| `claude_edit_json` | Edit with JSON response validation |

## Tool Parameters

All tools support these parameters:

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `prompt` | string | required | The prompt to send to Claude |
| `model` | string | "haiku" | Model: haiku, sonnet, opus |
| `timeout` | number | 660 | Timeout in seconds |
| `maxRetries` | number | 3 | Maximum retry attempts |
| `maxTurns` | number | - | Maximum agent turns |
| `outputFormat` | string | "json" | Output format: text, json, stream-json |
| `systemPrompt` | string | - | Replace default system prompt |
| `appendSystemPrompt` | string | - | Append to default system prompt |
| `allowedTools` | string[] | - | Additional tools to allow |
| `disallowedTools` | string[] | - | Tools to disallow |
| `addDirs` | string[] | - | Additional directories to access |
| `verbose` | boolean | false | Enable verbose logging |

## Architecture

```
src/
├── index.ts          # Entry point
├── server.ts         # MCP Server main logic
├── claude-cli.ts     # Claude CLI wrapper with retry
├── tools.ts          # Tool definitions
├── types.ts          # TypeScript types
└── utils.ts          # Utility functions
```

## License

MIT