code-mcp

Overview

Code-MCP is a Python-based MCP server that bridges Claude AI with local development environments, enabling AI to execute terminal commands, perform file operations, handle git repositories, and apply smart editing features to codebases. It provides comprehensive installation options including one-liners for macOS/Linux/Windows, with support for optional features like remote connectivity over SSH and Jupyter notebook integration. The server includes safety mechanisms for destructive operations and ensures all operations stay within the project directory.

Try asking AI

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

• run_command

  Execute terminal commands in the project directory

  Try:List all the files in the current directoryTry:Run git status and show me what files have changed
• git_operation

  Perform git operations with safety confirmations

  Try:Commit my changes with message 'Fix bug in authentication'Try:Show me the git log for the last 10 commits
• read_file

  Read the content of a file

  Try:Show me the content of the README.md fileTry:Read the requirements.txt file
• edit_file

  Edit a file with specified changes

  Try:Update the process_data function in data_utils.pyTry:Replace all instances of 'old_value' with 'new_value' in config.py
• smart_edit

  Perform smart code editing with pattern matching

  Try:Fix the indentation in this functionTry:Refactor this code to be more efficient
• create_directory

  Create a new directory

  Try:Create a new directory called 'utils'Try:Make a folder for my project assets
• delete_path

  Delete a file or directory with confirmation

  Try:Delete the temporary files directoryTry:Remove the outdated backup file
• list_directory

  List contents of a directory

  Try:Show me all Python files in the src directoryTry:List all subdirectories in the project root
• edit_block

  Perform batch operations across multiple files

  Try:Update the copyright notice in all Python filesTry:Refactor similar functions across multiple modules

Comparable tools

Installation

curl -LsSf https://raw.githubusercontent.com/54yyyu/code-mcp/main/install.sh | sh

powershell -c "Invoke-WebRequest -Uri https://raw.githubusercontent.com/54yyyu/code-mcp/main/install.ps1 -OutFile install.ps1; .\install.ps1"

code-mcp-setup /path/to/your/project

{
    "mcpServers": {
        "code": {
            "command": "code-mcp",
            "args": [
                "/path/to/your/project"
            ]
        }
    }
}

FAQ

Is Code-MCP compatible with Claude API or only Claude Desktop?

Code-MCP is primarily designed for Claude Desktop integration through MCP. While it might be possible to integrate with Claude API, the primary use case and documentation focus on Claude Desktop.

Does Code-MCP support remote development environments?

Yes, Code-MCP supports remote connectivity over SSH. You can connect Claude Desktop to a Code-MCP instance running on a remote server using the provided setup scripts and command-line tools.

What safety features does Code-MCP implement?

Code-MCP includes confirmation requirements for destructive operations (delete, overwrite), path safety to prevent operations outside the project directory, and special confirmations for potentially dangerous git commands.

Compare code-mcp with