Claude Code MCP

An MCP server that allows running Claude Code in one-shot mode with permissions bypassed automatically. This enables AI assistants to have an "agent in your agent" - delegating complex coding tasks to Claude Code directly.

Benefits

• Better File Editing: Cursor/Windsurf often struggle with complex file edits. Claude Code is better and faster at it.
• Cost Efficiency: Multiple commands can be queued instead of direct execution, saving context space. File ops, git, or other operations don't need costly models.
• Wider System Access: Claude has broader system access and can do things that Cursor/Windsurf can't do (or believe they can't).
• Agent Composition: Enables powerful agent-in-agent workflows.

Prerequisites

• Node.js v20 or later
• Claude CLI installed locally (run claude --dangerously-skip-permissions once to accept permissions)

Key Use Cases

Code Operations

• Generate, analyze, and refactor code
• Parse data and transform formats
• Identify bugs and suggest improvements

File System Operations

• Create, read, edit, and manage files
• Move, copy, and delete files
• Complex multi-file operations

Version Control

• Stage, commit, and push changes
• Create branches and tags
• Manage pull requests

Development Workflows

• Run build commands and scripts
• Fix syntax errors and configuration issues
• Automate version bumps and releases
• Interact with GitHub (PRs, CI checks)

Web & Research

• Search the web and summarize results
• Open URLs in browser

Tools

claude_code

Executes prompts using Claude Code CLI with permissions bypassed.

Arguments:

• prompt (string, required): The prompt to send to Claude Code
• options (object, optional):
  • tools (array of strings): Specific Claude tools to enable (e.g., Bash, Read, Write)

Important: Provide current working directory context in prompts for file system or git operations:

Your work folder is /path/to/project

[your command here]

Troubleshooting

• Command not found: Ensure npm global bin is in PATH (if globally installed) or that npx is working
• Claude CLI not found: Install with npm install -g @anthropic-ai/claude-code
• Permissions Issues: Run claude --dangerously-skip-permissions once to accept terms
• JSON Errors: Set MCP_CLAUDE_DEBUG=false for normal operation