# MCP 服务器

独立的 **MCP**（Model Context Protocol）服务器允许 AI 客户端
通过*此* API 控制启动器，并通过 CDP 控制配置文件的浏览器。
这是一个独立的 Node 进程，**不**是本 HTTP API 的组成部分，
也不由其托管。可直接从启动器下载
（**Settings → MCP server → Download MCP server** 或侧边栏"Download MCP"按钮）；
启动器会将源代码保存到所选文件夹。
也可从仓库获取：`rust/shardx-launcher/mcp/`。

其底层只是调用此 API：配置
`SHARDX_API`（基础 URL）和 `SHARDX_TOKEN`（来自
*Settings → Automation API* 的 Bearer 令牌）。MCP 服务器提供：
- **API 工具，作为下方端点的轻量封装
  （配置文件、指纹、代理、文件夹、cookies、启动/停止）。
- **浏览器工具**（基于 CDP 的 patchright），`browser_navigate`、
  `browser_evaluate`、`browser_screenshot`、`browser_click`、
  `browser_fill`、标签页管理、等待操作等，作用于通过
  `POST /profiles/{id}/start` 启动的配置文件（该端点返回
  CDP 端点）。

启动方式：通过 **stdio**（由客户端启动）或通过 HTTP
在 `127.0.0.1:<port>/mcp`（若设置了 `MCP_HTTP_PORT`）。详情见
MCP 服务器的 README。（启动器仅负责下载，不负责运行。）