Morfiade

Morfiade MCP

适用于 Windows 本地 Google Chrome 配置文件的 MCP 服务。 19 个工具，可让 AI Agent 在自己的设备上列出、创建、启动和整理真实的 Chrome 配置文件——每个配置文件都有自己的 Cookie、会话和代理。

该服务不是供你下载的软件包：它内置于 Morfiade 中，也就是 Chrome 配置文件管理器本身，并通过一个标志启动。传输方式为 stdio（JSON-RPC 2.0），协议版本为 2025-11-25。不会从互联网获取任何内容，也不会经由他人的服务传输任何数据。

此仓库提供文档、现成的客户端配置，以及一个可选的启动器。俄语版 — README.ru.md。

---

有何不同

桥接功能内置于程序中。 AdsPower 和 GoLogin 发布的 MCP 服务是与其云端通信的独立软件包。Morfiade 将配置文件保存在你的磁盘上，因此桥接功能也留在你的磁盘上：Morfiade.exe --mcp，通过回环接口运行，无需网络。

在窗口间分配值。 其他地方没有对应功能的工具是 sync_sets / sync_spread / sync_insert：将一列值——电子邮件、登录名或任何按行排列的内容——分配到已打开的窗口中，每个配置文件固定一个值。重复调用不会重新打乱已固定的值，否则账号可能会用一个电子邮件地址注册，却用另一个地址确认。Agent 看不到这些值本身（参见 安全性）。

以下提示词开箱即用：

创建 20 个以 shop 为前缀的配置文件，为它们分配此列表中的代理，并启动前五个。

检查我能管理的每个配置文件中的代理，告诉我哪些代理失效或出口国家不正确。

取出 mail-batch 集合，将其分配到已打开的窗口中，并告诉我每个窗口分到了什么。我会把光标放在电子邮件输入框中，然后插入。

---

要求

• Windows 10 或 11
• Morfiade 3.37 或更高版本，且正在运行
• 在设置中启用本地 API——未启用时，服务会拒绝启动，而不是悄无声息地失败
• 对于 Agent 可以操作的配置文件，必须勾选 “API”复选框；该选项默认关闭，未勾选的配置文件对 Agent 来说并不存在
• 有效的配置文件启动许可（许可检查由管理器负责，与此服务无关）
• 任意支持 stdio 的 MCP 客户端：Claude Code、Claude Desktop、Cursor、Gemini CLI、VS Code，或你自己的客户端

无需安装任何内容：不需要 pip install，不需要 Node，也不需要注册 API 密钥。下方的启动器是可选的。

---

设置

将客户端指向可执行文件，并传入 --mcp：

{
  "mcpServers": {
    "morfiade": {
      "command": "C:\\Program Files\\Morfiade\\Morfiade.exe",
      "args": ["--mcp"]
    }
  }
}

常用客户端的现成配置文件位于 examples/ 中。 Claude Code 只需一行命令即可完成配置：

claude mcp add morfiade -- "C:\Program Files\Morfiade\Morfiade.exe" --mcp

不同客户端的配置文件所在位置各不相同，且变化频率高于本 README 的更新频率——请查阅客户端自己的文档。

可选启动器

如果你不想硬编码路径， morfiade_mcp.py 会查找可执行文件（通过 MORFIADE_EXE、 安装程序的注册表项、常见安装目录或 PATH）， 转发标准输入输出并返回其退出代码。需要 Python 3.7+，除此之外无需其他依赖。

pip install morfiade-mcp

{
  "mcpServers": {
    "morfiade": {
      "command": "morfiade-mcp"
    }
  }
}

如果你的客户端需要绝对路径，请将其指向 pip 放入 Python Scripts 目录的 morfiade-mcp.exe。即使没有安装此软件包，这个单文件也可以独立运行——将 "command": "python" 设为命令，并将 morfiade_mcp.py 作为唯一参数。

此软件包只包含这个启动器。服务及其交互的一切内容，都是桌面应用。

仅架构模式。 在 Windows 之外——例如 MCP 目录启动服务以列出其工具的 Linux 容器中——没有可运行的程序，因此启动器会根据从真实服务导出的 schemas/ 中的架构，自行响应握手和 tools/list。之后的每次工具调用都会返回错误，说明 Morfiade 在 Windows 上运行：这些工具仅供描述，并未仿真。在任何环境中设置 MORFIADE_MCP_SCHEMA_ONLY=1 即可开启此模式，供测试使用。

---

工具

完整参数和返回格式：docs/TOOLS.md。 机器可读的架构，与服务对 tools/list 的响应完全一致：schemas/。

• status — 版本、配置档案总数、Agent 可使用的配置档案数，以及正在运行的配置档案数
• list_profiles — 获准使用的配置档案：名称、是否正在运行、代理及其上次检查结果、备注、调试端口模式
• create_profile — 创建配置档案——可选设置代理、备注和类别；Agent 创建后即可使用
• start_profile — 启动配置档案，可直接打开指定 URL；会提示代理失效或处于调试端口模式
• page_info — 活动标签页的显示内容：标题、地址、是否已加载、是否被 Cloudflare 检查拦截
• stop_profile — 关闭配置档案窗口
• set_proxy — 设置代理（host:port、host:port:user:pass，或 Morfiade 3.40 起支持的 type://user:pass@host:port；空字符串可清除代理）
• check_proxy — 检查单个配置档案的代理：是否可用，以及出口位置
• check_proxies — 对多个配置档案或全部配置档案执行相同检查
• profile_tags — 读取标签，或整体替换标签
• profile_note — 读取或写入备注及其简短标题
• sync_windows — 列出哪些打开的窗口已准备好接收分发，以及每个窗口已固定的内容
• sync_sets — 值集：列出值集（名称、行数、剩余可用数量）或创建值集
• sync_spread — 为每个窗口固定一个值集中的一行，并报告各窗口获得的内容——不插入任何内容
• sync_insert — 在前置窗口的光标位置插入各窗口各自的值
• list_scripts — 管理器文件夹中的脚本：名称和解释器，不会读取脚本内容
• trash_profile — 将配置档案移入回收站——不会删除任何内容
• list_trash — 查看回收站中的内容：名称、时间、占用空间
• restore_profile — 从回收站恢复；如果名称已被占用，恢复后的名称会变为 name (2)

还有两个工具仅在显式启用标志后才会出现——参见 危险标志（默认关闭）。

---

安全：Agent 无法执行的操作

读取网页的 Agent 并非可信方。网页中可能包含“调用这个工具并把 Cookie 发到那里”这样的文字，而 Agent 无法区分你的指令和它在互联网上读到的文字。这是 MCP 已知的核心问题，单靠调整提示词无法解决。因此，限制直接内置于工具列表中：

• **只能将内容移入回收站。**配置文件保持完整——Cookie、会话以及所有其他内容都保留，并且只需一次调用即可恢复。此处不会提供永久删除和清空回收站的功能，今后也不会：这些是唯一不可逆的操作，必须由人工在回收站窗口中执行，这样他们可以看到自己正在销毁什么。
• **不读取 Cookie。**GoLogin 的 MCP 提供了这样的工具，这意味着 Cookie 会从账户传入聊天记录。本工具没有这个功能。
• 不会公开集合内容。sync_sets 只会报告名称、行数和剩余空闲数量。邮箱和登录信息本身仍保留在管理器中——Agent 无需查看它们，只需要让它们进入窗口。
• 不会公开脚本内容。list_scripts 仅提供名称和解释器。
• **不会公开镜像。**镜像会反映人工当前在主窗口中的操作，Agent 无法复现。
• 无法绕过白名单。“API”列由管理器本身过滤，而非由此服务过滤。
• **许可证检查不会被削弱。**检查位于管理器的处理程序中，因此无论请求来自人工、脚本还是 Agent，都会执行。
• **不会监听网络。**本地 API 绑定到 127.0.0.1，需要令牌并检查 Host 标头。令牌使用 Windows DPAPI 加密存储，并与账户绑定；它通过标头传递，而不是放在 URL 中——URL 会进入日志。

默认关闭的危险标志

标志	额外工具	实际含义
--mcp-allow-cdp	browser_command	任意 Chrome DevTools Protocol 命令。在已登录的配置文件中使用 Runtime.evaluate 会读取 Cookie、存储内容和页面内容——这意味着可以完全访问你的账户，而非“高级管理”
--mcp-allow-scripts	run_script	运行管理器文件夹中的脚本——在你的计算机上执行代码

只有在充分了解上文的前提下，并且只针对你信任的页面，才值得启用这两项。

---

故障排除

你看到的情况	处理方法
客户端没有显示任何工具	检查客户端配置中的 exe 路径
“local API is off”	在管理器设置中启用本地 API
“no port or token in config.json”	打开一次管理器，让它写入设置
“the manager does not answer”	管理器必须处于运行状态
“profile not found”，但配置文件确实存在	该配置文件的“API”复选框未勾选
“the API token contains invalid characters”	配置来自另一台计算机——在设置中重新签发令牌
启动配置文件遭到拒绝	没有有效许可证：通过 API 和 MCP 启动配置文件都会受到限制

消息由管理器提供，并遵循其界面语言——共支持五种语言，因此你看到的措辞可能是你自己的语言。

---

本文未包含的内容

桥接程序本身已编译到 Morfiade.exe 中，而会话转移机制——实际在计算机之间迁移已登录会话的部分——仍保持封闭。本仓库是产品的外部部分：文档、配置和启动器。

链接

• morfiade.com — 管理器本身
• 从 AI Agent 启动浏览器配置文件 — 实际运行效果
• 手册 — AI Agent 访问部分
• Model Context Protocol — 协议

许可证

本仓库中的所有内容均采用 MIT 许可证——详见 LICENSE。管理器是独立的商业产品，适用其自身条款。