MCP Claude Shell Server

Node.js MCP server that wraps Claude Code CLI for parallel Claude requests with retry and model options.

typescript

0

GitHub Stars

typescript

Language

3 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sunalamye-mcp-claude-node": {
      "command": "node",
      "args": [
        "/path/to/mcp-claude-node/dist/index.js"
      ]
    }
  }
}

You can run Claude AI requests in parallel by using a dedicated MCP server that wraps the Claude Code CLI. This enables concurrent handling, retry logic, and model selection for Haiku, Sonnet, and Opus, while validating outputs and exposing all Claude CLI options to your MCP client.

How to use

To use this server with an MCP client, add it as a stdio MCP server so your client can communicate with a local process that runs Claude requests. The server exposes several tools for generating, editing, and refining code or text via Claude with built-in retry and model handling.

Configure yourClaude-based MCP client to connect to the local Claude Shell MCP server using the following setup. First, register or launch the server in your Claude Code environment to enable stdio transport.

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

Alternatively, you can place an MCP configuration entry in your Claude credentials file to point at the local process. The example below shows the exact structure to use in your ~/.claude.json file.

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

How to install

Prerequisites: you need Node.js installed on your system. You will also interact with Claude via the Claude Code CLI through this MCP server.

Install dependencies and build the MCP server package.

npm install
npm run build

If you are developing or testing locally, run in development mode and then build for production as needed.

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npx tsx test-client.ts

Notes

This MCP server supports parallel request handling, automatic retry with configurable attempts and timeouts, and model selection among Haiku, Sonnet, and Opus. It includes JSON validation for structured outputs and honors all Claude CLI options such as system prompts and tool permissions.

Available tools

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