codemcp  by ezyang

Coding assistant for Claude Desktop, enabling code edits and testing

created 4 months ago
1,517 stars

Top 27.8% on sourcepulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

This project provides a coding assistant for Claude Desktop, enabling users to directly ask Claude to implement features, fix bugs, and refactor codebases. It targets developers who use Claude Pro for coding tasks, offering a cost-effective alternative to API-based solutions by leveraging a subscription model and enforcing safe agentic practices.

How It Works

The system integrates with Claude Desktop as a "MCP Server," allowing Claude to interact with the local filesystem and execute predefined commands (like running tests or formatters). It prioritizes safety through a limited toolset and Git version control for easy rollback, ensuring changes can be reviewed and accepted or rejected.

Quick Start & Requirements

  • Installation: Install via uv (uv x --from git+https://github.com/ezyang/codemcp@prod codemcp) or globally with pip install git+https://github.com/ezyang/codemcp@prod.
  • Prerequisites: Git, Python 3.12+.
  • Configuration: Requires modification of claude_desktop_config.json to register the MCP server.
  • Setup: Create a codemcp.toml file in the project directory to define commands.
  • Docs: https://github.com/ezyang/codemcp

Highlighted Details

  • Integrates directly with Claude Desktop for in-place code modification.
  • Designed for Claude Pro subscription users to avoid high API costs.
  • Employs Git for version control, enabling safe, reversible code changes.
  • IDE-agnostic, allowing review and further edits in any preferred IDE.

Maintenance & Community

  • The project is maintained by ezyang.
  • Contribution guidelines are available in CONTRIBUTING.md.

Licensing & Compatibility

  • The README does not explicitly state a license. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The project is not an autonomous agent and requires user intervention after each chat to review and approve changes. Users may encounter Claude Desktop's output limits, necessitating manual continuation.

Health Check
Last commit

2 months ago

Responsiveness

1 day

Pull Requests (30d)
1
Issues (30d)
0
Star History
304 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.