mcp-claude-code

Overview

MCP Claude Code is a comprehensive implementation that translates Claude Code functionality into the MCP protocol, enabling direct file manipulation and code analysis through MCP clients. It provides extensive file system tools including read, write, edit, and search capabilities with AST context, plus support for Jupyter notebooks. The server implements security measures like permission prompts and directory restrictions.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• read

  Read file contents with line numbers, offset, and limit capabilities

  Try:Read the contents of src/main.jsTry:Show me lines 10-20 of config.yaml
• write

  Create or overwrite files

  Try:Create a new file named README.md with basic infoTry:Write a Python script that calculates Fibonacci numbers
• edit

  Make line-based edits to text files

  Try:Fix the typo in line 5 of index.htmlTry:Add a new function to utils.py
• directory_tree

  Get a recursive tree view of directories

  Try:Show me the structure of the src directoryTry:List all files in the project
• grep

  Fast pattern search in files with ripgrep integration

  Try:Find all occurrences of 'TODO' in the codebaseTry:Search for 'function' in all Python files
• content_replace

  Replace patterns in file contents

  Try:Replace all instances of 'old-api' with 'new-api'Try:Update copyright year in all files
• run_command

  Execute shell commands

  Try:Run npm install in the project directoryTry:List all files with .md extension
• notebook_read

  Extract and read source code from all cells in a Jupyter notebook

  Try:Read the data analysis notebookTry:Show me all Python cells in the notebook
• notebook_edit

  Edit, insert, or delete cells in a Jupyter notebook

  Try:Add a new cell at the end of the notebookTry:Delete the first cell
• think

  Structured space for complex reasoning and analysis without making changes

  Try:Analyze this code structure and suggest improvementsTry:Plan the implementation of a new feature
• dispatch_agent

  Launch one or more agents that can perform tasks using read-only tools concurrently

  Try:Dispatch an agent to review the code qualityTry:Start an agent to find security vulnerabilities
• batch

  Execute multiple tool invocations in parallel or serially in a single request

  Try:Run multiple file operations at onceTry:Process several files with different commands

Comparable tools

Installation

pip install mcp-claude-code

{
  "mcpServers": {
    "claude-code": {
      "command": "python",
      "args": ["-m", "mcp_claude_code.server"],
      "env": {
        "MCP_CLAUDE_CODE_PATH": "/path/to/your/project"
      }
    }
  }
}

FAQ

Is this server compatible with MCP clients other than Claude Desktop?

Yes, the MCP Claude Code server is designed to work with any MCP-compliant client that supports the MCP protocol.

What security measures are in place?

The server implements permission prompts for file modifications, restricted directory access, input validation, and proper error handling.

Compare mcp-claude-code with