Skip to main content

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.

example

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.

Metadata

Release files for iflow-mcp_mcp-claude-code 0.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_mcp-claude-code 0.5.1
File Size Uploaded
iflow_mcp_mcp_claude_code-0.5.1.tar.gz 92.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_mcp-claude-code 0.5.1
File Interpreter ABI Platform
iflow_mcp_mcp_claude_code-0.5.1-py3-none-any.whl Python 3 none any Details

Total release size: 215.8 kB

Release files / iflow_mcp_mcp_claude_code-0.5.1.tar.gz

Download URL iflow_mcp_mcp_claude_code-0.5.1.tar.gz
Size 92.7 kB
Tags Source
SHA-256 checksum
How to use checksums
d138f76a4ad9062f74879b89f71f96d1cf6753390a508181306fc2ce424f9d08
BLAKE2b-256 checksum
How to use checksums
3931e0eed2d91d2d9a17e4061932b004de365016fa45faa035e42c32550f5c29
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.9

Release files / iflow_mcp_mcp_claude_code-0.5.1-py3-none-any.whl

Download URL iflow_mcp_mcp_claude_code-0.5.1-py3-none-any.whl
Size 123.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2f1afad765ae1a8a948c46bc90c0d7c01d00123c7a00ae22e1af97a5b55cb07b
BLAKE2b-256 checksum
How to use checksums
4eab3502548031055af08f9f30bc525c2662faca928e9b82afb9eb08ca57dc01
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.9

Release history Release notifications | RSS feed

This release

0.5.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page