Public

mcp-claude-code

Try Now

2025-04-10

MCP implementation of Claude Code capabilities and more

3 years

Works with Finder

0

Github Watches

7

Github Forks

107

Github Stars

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
Project Analysis: Understand project structure, dependencies, and frameworks
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_files`	Read one or multiple files with encoding detection
`write_file`	Create or overwrite files
`edit_file`	Make line-based edits to text files
`directory_tree`	Get a recursive tree view of directories
`get_file_info`	Get metadata about a file or directory
`search_content`	Search for patterns in file contents
`content_replace`	Replace patterns in file contents
`run_command`	Execute shell commands (also used for directory creation, file moving, and directory listing)
`run_script`	Execute scripts with specified interpreters
`script_tool`	Execute scripts in specific programming languages
`project_analyze_tool`	Analyze project structure and dependencies
`read_notebook`	Extract and read source code from all cells in a Jupyter notebook with outputs
`edit_notebook`	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

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:

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

License

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

Reviews

5 (1)

user_C5cZ2jbk

2025-04-17

As an avid user of mcp-claude-code by SDGLBL, I am thoroughly impressed with its functionality and ease of use. This powerful tool, available on GitHub (https://github.com/SDGLBL/mcp-claude-code), offers remarkable versatility and efficiency. The seamless integration and user-friendly design have significantly streamlined my coding process, making it an essential addition to my toolkit. Kudos to the team for developing such a stellar product!