Charles-mcp

InstallView on GitHub

Charles-mcp is an MCP server by heizaheiza. Charles Proxy MCP server for AI agents with live capture, structured traffic analysis, and agent-friendly tool contracts. It has 329 GitHub stars and ranks #273 of 2217 in Developer Tools by stars.

Category
Developer Tools
Author
heizaheiza
GitHub stars
329
This week
Tracking since 18 Oct 2026
Language
Python
License
MIT (open source)
Last update
2026-06-23 (4 months ago)
Links
SourceWebsitePyPI

How to install Charles-mcp

Charles-mcp is published on PyPI as charles-mcp, and it depends on mcp. These steps assume it runs as a local stdio server, which is the usual setup.

  1. Check the README. Confirm the start command and note any API keys or environment variables it needs (pass them with -e KEY=value or an env block). You need uv for uvx.
  2. Add it to Claude Code from a terminal:
    claude mcp add Charles-mcp -- uvx charles-mcp
  3. Or add it to Cursor or Claude Desktop in .cursor/mcp.json or claude_desktop_config.json:
    {
      "mcpServers": {
        "Charles-mcp": {
          "command": "uvx",
          "args": [
            "charles-mcp"
          ]
        }
      }
    }
  4. Restart the client and check it. Run claude mcp list, or open the client's MCP settings, and confirm Charles-mcp and its tools are listed. The install guide covers VS Code and Codex.

Also listed in

Maintain this project? Get it featured ($99/mo, pinned at the top of Developer Tools) or see what featuring includes.

Report a problem with this listing

Frequently asked questions

What is Charles-mcp?

Charles-mcp is an MCP server by heizaheiza in the Developer Tools category. Charles Proxy MCP server for AI agents with live capture, structured traffic analysis, and agent-friendly tool contracts. It has 329 GitHub stars and ranks #273 of 2217 in Developer Tools by stars. It is written in Python. It is licensed under MIT. It was last updated 4 months ago.

Is Charles-mcp free and open source?

Yes. Charles-mcp is published under the MIT license, so you can run, modify and self-host it at no cost. If it connects to a paid service, that service's own pricing and API terms still apply. Check the repository for the exact license text before using it commercially.

What are the alternatives to Charles-mcp?

Other Developer Tools projects on MCP Harbor include rea, storybook, context7. Each alternative links to its own page with stars, license and recent activity. The Developer Tools category ranks all 2217 by stars, and you can re-sort it by growth this week.

Alternatives to Charles-mcp

reaTrending★ 374,738
morluto · TypeScript+72,150 stars this week (+23.8%)
Reverse engineer anything with agents, from app behavior down to native binaries.
storybook★ 91,361
storybookjs · TypeScript
Storybook is the industry standard workshop for building, documenting, and testing UI components in isolation
upstash · TypeScript+372 stars this week (+0.6%)
Context7 Platform -- Up-to-date docs for AI agents
GitNexus★ 48,013
abhigyanpatwari · TypeScript
GitNexus: The Zero-Server Code Intelligence Engine
DeusData · C+622 stars this week (+1.3%)
Local code intelligence for developers and AI agents. Connect code, docs and infrastructure in a persistent graph, with CBM Lens, MCP tools, agent integrations and change-aware test selection.
github · Go+219 stars this week (+0.7%)
GitHub's official MCP Server

All 2217 Developer Tools MCP servers →

Data last updated . Stars and downloads are refreshed every day from GitHub and npm.

Contact MCP Harbor

We reply by email. You can also write to hello@spone.io.

Report a problem with this listing

Charles-mcpheizaheiza · /tools/heizaheiza-charles-mcp/

We reply by email.