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
npm install
npm run build
Usage
As MCP Server
Add to your Claude Code configuration:
claude mcp add --transport stdio claude-shell -- node /path/to/mcp-claude-node/dist/index.js
Or manually add to ~/.claude.json:
{
"mcpServers": {
"claude-shell": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-claude-node/dist/index.js"]
}
}
}
Development
# 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