mcp-claude-code
MCP implementation of Claude Code capabilities and more Python-based implementation.
Documentation
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 with high-performance searching
- 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
| Tool | Description |
|---|---|
| `read` | Read file contents with line numbers, offset, and limit capabilities |
| `write` | Create or overwrite files |
| `edit` | Make line-based edits to text files |
| `multi_edit` | Make multiple precise text replacements in a single file operation with atomic transactions |
| `directory_tree` | Get a recursive tree view of directories |
| `grep` | Fast pattern search in files with ripgrep integration for best performance (docs) |
| `content_replace` | Replace patterns in file contents |
| `grep_ast` | Search code with AST context showing matches within functions, classes, and other structures |
| `run_command` | Execute shell commands (also used for directory creation, file moving, and directory listing) |
| `notebook_read` | Extract and read source code from all cells in a Jupyter notebook with outputs |
| `notebook_edit` | Edit, insert, or delete cells in a Jupyter notebook |
| `think` | Structured space for complex reasoning and analysis without making changes |
| `dispatch_agent` | Launch one or more agents that can perform tasks using read-only tools concurrently |
| `batch` | Execute multiple tool invocations in parallel or serially in a single request |
| `todo_write` | Create and manage a structured task list |
| `todo_read` | Read a structured task list |
Getting Started
For detailed installation and configuration instructions, please refer to INSTALL.md.
For detailed tutorial of 0.3 version, please refer to TUTORIAL.md
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.
Frequently asked questions
What is mcp-claude-code?
mcp-claude-code is MCP implementation of Claude Code capabilities and more Python-based implementation.
How do I install mcp-claude-code?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mcp-claude-code open source?
Yes — it is hosted on GitHub at https://github.com/SDGLBL/mcp-claude-code and has 278 stars.
Related MCP tools
linkedin-mcp-serverThis MCP server allows Claude and other AI assistants to access your LinkedIn. Scrape LinkedIn profiles and companies, get your recommended jobs, and perform...
mcp-google-adsAn MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations.
serenaA powerful coding agent toolkit providing semantic retrieval and editing capabilities (MCP server & other integrations) Python-based implementation.
fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth! Python-based implementation. Trusted by 11000+ developers.
mcp-server-qdrantAn official Qdrant Model Context Protocol (MCP) server implementation Python-based implementation. Trusted by 1000+ developers.
mcp-bridgeA middleware to provide an openAI compatible endpoint that can call MCP tools Python-based implementation. Trusted by 800+ developers.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP