Charles MCP Server

仓库维护公告(2026-04-21) 本仓库的公开 Git 历史已于 2026-04-21 重新整理。如果你在该日期之前克隆过本仓库,请在继续贡献前重新克隆。不要从旧的本地克隆直接合并或推送,否则可能会把过期历史重新引入仓库。

Local serverstdio

What is the Charles MCP Server?

Charles is an MCP project maintained in the heizaheiza/charles-mcp repository. The maintainer describes its purpose as “仓库维护公告(2026-04-21) 本仓库的公开 Git 历史已于 2026-04-21 重新整理。如果你在该日期之前克隆过本仓库,请在继续贡献前重新克隆。不要从旧的本地克隆直接合并或推送,否则可能会把过期历史重新引入仓库。”. Read the project documentation for the complete scope.

Installation

The documented pypi package is charles-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares CHARLES_USER, CHARLES_PASS, CHARLES_MANAGE_LIFECYCLE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the Charles MCP Server

{
  "mcpServers": {
    "charles": {
      "command": "uvx",
      "args": [
        "charles-mcp"
      ],
      "env": {
        "CHARLES_USER": "admin",
        "CHARLES_PASS": "123456",
        "CHARLES_MANAGE_LIFECYCLE": "false"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
CHARLES_USERDeclared in the maintainer’s client configuration.Check documentation
CHARLES_PASSDeclared in the maintainer’s client configuration.Check documentation
CHARLES_MANAGE_LIFECYCLEDeclared in the maintainer’s client configuration.Check documentation