Claude Code MCP Server

MCP server that runs Claude Code as a tool -- with session continuity.

Provides two tools via the Model Context Protocol:

• claude_code -- Run Claude Code in one-shot mode with any prompt
• claude_code_reply -- Continue a previous conversation by thread ID

Both tools parse structured JSON output from the CLI, returning session_id for threading and is_error for error detection. A 30-minute execution timeout prevents runaway processes.

Quick Start

npx @pandysp/claude-code-mcp@latest

Requires Node.js 20+ and the Claude CLI installed locally.

First-time setup

Accept the CLI permissions once before the MCP server can use them:

npm install -g @anthropic-ai/claude-code
claude --dangerously-skip-permissions

Configuration

Add to your MCP client config:

Claude Desktop / Cursor

{
  "mcpServers": {
    "claude-code-mcp": {
      "command": "npx",
      "args": ["-y", "@pandysp/claude-code-mcp@latest"]
    }
  }
}

Windsurf

{
  "mcpServers": {
    "claude-code-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pandysp/claude-code-mcp@latest"]
    }
  }
}

OpenClaw (Docker)

When running inside a Docker container (e.g., as an OpenClaw MCP adapter server), use the container's node binary directly instead of npx:

{
  "command": "node",
  "args": ["/path/to/dist/server.js"]
}

Tools Reference

claude_code

Run Claude Code with a one-shot prompt.

Parameter	Type	Required	Description
prompt	string	yes	The prompt to send to Claude Code
workFolder	string	no	Absolute path to the working directory

Returns the CLI result text. If the CLI outputs JSON with a session_id, the response includes structuredContent.threadId for use with claude_code_reply.

claude_code_reply

Continue a previous Claude Code conversation.

Parameter	Type	Required	Description
threadId	string	yes	Session ID from a previous call
prompt	string	yes	Follow-up prompt
workFolder	string	no	Should match the original call's working directory

Uses --resume <threadId> under the hood to maintain conversation context.

Environment Variables

Variable	Default	Description
CLAUDE_CLI_NAME	claude	Override the CLI binary name or absolute path
MCP_CLAUDE_DEBUG	false	Enable verbose debug logging to stderr

CLAUDE_CLI_NAME supports simple names (looked up in PATH) or absolute paths. Relative paths are rejected.

Development

npm install
npm run build
npm run test:unit    # 100 unit tests, fully mocked
npm run dev          # dev mode with tsx

Attribution

Originally forked from @steipete/claude-code-mcp.

License

MIT