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

MCP Claude Shell Server