Skip to main content
Glama
Sign In
MCP Claude Shell Server

MCP Claude Shell Server

by Sunalamye
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

Related MCP server: SystemPrompt Coding Agent

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

Available Tools

5 tools
claude_editC

Edit files via Claude Code CLI with retry and model selection

Inputs: prompt (required), model, timeout, maxRetries, +10 more.

claude_edit_jsonC

Edit with JSON response validation and retry

Inputs: prompt (required), model, maxRetries, jsonSchema, +2 more.

claude_generateC

Generate code or text via Claude Code CLI with retry and model selection

Inputs: prompt (required), model, timeout, maxRetries, +10 more.

claude_generate_jsonC

Generate JSON response with validation and retry

Inputs: prompt (required), model, maxRetries, jsonSchema, +2 more.

claude_refactorC

Refactor code via Claude Code CLI with retry and model selection

Inputs: prompt (required), model, timeout, maxRetries, +10 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    B3/5.0

    Scored across 5 tools

    Disambiguation3/5

    The tools have clear distinctions in their primary functions (edit, generate, refactor), but there is significant overlap between the regular and JSON variants. For example, claude_edit and claude_edit_json both edit files, differing only in response validation, which could cause confusion about when to use each. Similarly, claude_generate and claude_generate_json overlap in purpose. This ambiguity is mitigated by descriptive names, but agents might still misselect between similar tools.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with a clear prefix 'claude_' and a verb (edit, generate, refactor) followed by an optional suffix (_json). This predictable naming scheme makes it easy to understand the tool's purpose and relationships, such as distinguishing between base operations and JSON-specific variants. There are no deviations in style or convention across the set.

    Tool Count4/5

    With 5 tools, the count is reasonable for a server focused on Claude Code CLI interactions, covering key operations like editing, generating, and refactoring. However, it feels slightly thin as it lacks tools for other common CLI tasks (e.g., running commands or managing files), but each tool earns its place within the defined scope. The number is well-scoped without being excessive or minimal.

    Completeness3/5

    The tool set covers core operations for interacting with Claude Code CLI (edit, generate, refactor), but there are notable gaps. For example, it lacks tools for executing or running code, managing project files, or handling non-JSON validation scenarios, which could limit agent workflows. The inclusion of JSON variants adds depth for validation, but the overall surface feels incomplete for a comprehensive shell or CLI server.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP Claude Code

      SDGLBL
      A
      license
      A
      quality
      D
      maintenance
      An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
      15
      306
      MIT

    • Codex MCP Server

      tom-wahl
      F
      license
      B
      quality
      Not graded
      maintenance
      An MCP server for the OpenAI Codex CLI that provides coding assistance with multi-turn session management and reasoning depth control. It enables users to perform code analysis, generation, and refactoring through Claude with native resume support for conversational context.
      4
      1,656 npm
      1
      -

    • mcp-codex-dev

      FYZAFH
      A
      license
      A
      quality
      D
      maintenance
      An MCP server that integrates Codex CLI into Claude Code workflows for code writing, execution, and review with session management. It features real-time progress monitoring via a local HTTP dashboard and supports detailed configuration for various coding tools.
      6
      11 npm
      166
      MIT