MCP Claude Code

by SDGLBL

MCP Claude Code

An implementation of Claude Code capabilities using the Model Context Protocol (MCP).

Overview

This project provides an MCP server that implements Claude Code-like functionality, allowing Claude to directly execute instructions for modifying and improving project files. By leveraging the Model Context Protocol, this implementation enables seamless integration with various MCP clients including Claude Desktop.

Features

  • Code Understanding: Analyze and understand codebases through file access and pattern searching
  • Code Modification: Make targeted edits to files with proper permission handling
  • Enhanced Command Execution: Run commands and scripts in various languages with improved error handling and shell support
  • File Operations: Manage files with proper security controls through shell commands
  • Code Discovery: Find relevant files and code patterns across your project
  • Agent Delegation: Delegate complex tasks to specialized sub-agents that can work concurrently
  • Multiple LLM Provider Support: Configure any LiteLLM-compatible model for agent operations
  • Jupyter Notebook Support: Read and edit Jupyter notebooks with full cell and output handling

Tools Implemented

ToolDescription
read_filesRead one or multiple files with encoding detection
write_fileCreate or overwrite files
edit_fileMake line-based edits to text files
directory_treeGet a recursive tree view of directories
get_file_infoGet metadata about a file or directory
search_contentSearch for patterns in file contents
content_replaceReplace patterns in file contents
grep_astSearch code with AST context showing matches within functions, classes, and other structures
run_commandExecute shell commands (also used for directory creation, file moving, and directory listing)
run_scriptExecute scripts with specified interpreters
script_toolExecute scripts in specific programming languages
read_notebookExtract and read source code from all cells in a Jupyter notebook with outputs
edit_notebookEdit, insert, or delete cells in a Jupyter notebook
thinkStructured space for complex reasoning and analysis without making changes
dispatch_agentLaunch one or more agents that can perform tasks using read-only tools concurrently

Getting Started

For detailed installation and configuration instructions, please refer to INSTALL.md.

Of course, you can also read USEFUL_PROMPTS for some inspiration on how to use mcp-claude-code.

Security

This implementation follows best practices for securing access to your filesystem:

  • Permission prompts for file modifications and command execution
  • Restricted access to specified directories only
  • Input validation and sanitization
  • Proper error handling and reporting

Development

To contribute to this project:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

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.

  1. Overview
    1. Features
      1. Tools Implemented
        1. Getting Started
          1. Security
            1. Development
              1. License

                Related MCP Servers

                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that allows Claude AI to perform filesystem operations including reading, writing, listing, moving files, and searching directories within specified allowed paths.
                  Last updated -
                  5
                  1
                  JavaScript
                • -
                  security
                  A
                  license
                  -
                  quality
                  A local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.
                  Last updated -
                  60
                  TypeScript
                  MIT License
                  • Apple
                  • Linux
                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.
                  Last updated -
                  7
                  Python
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  An MCP server that analyzes codebases and generates contextual prompts, making it easier for AI assistants to understand and work with code repositories.
                  Last updated -
                  2
                  Python
                  MIT License

                View all related MCP servers

                ID: q52ygj7qx3