bolloplayer/affinity-mcp-setup

Affinity Photo MCP 设置 — 将 Claude Code、Codex、Antigravity、OpenCode 和 DeepSeek Harness 连接到 Affinity Photo v3 内置的 MCP 服务器（Windows）

Affinity Photo v3 内置了一个 MCP 服务器。 这意味着 AI 代理 —— Claude Code、Codex、
Antigravity、OpenCode 或 DeepSeek Harness —— 可以在应用内编写并运行真正的脚本：调整图层、滤镜、
批处理，全部通过 Affinity 自有的 JavaScript SDK 完成。无需额外软件，无需 UI 自动化，无需
macOS 要求。

本仓库的存在是为了让你的代理为你完成这项连接设置。 把它指向这里，它就会
找到它所运行的 harness 对应的配置，以及那些否则会耗费一下午时间的少数几个不明显的陷阱。

直接问你的 AI

打开 Affinity Photo，启用 Edit ▸ Settings ▸ Model Context Protocol ▸ Enable Affinity MCP，
然后把这段粘贴到你的代理中：

在 Windows 上设置一个到 Affinity Photo 的 MCP 服务器的连接。

遵循 github.com/bolloplayer/affinity-mcp-setup —— 阅读其中的 SETUP.md，并按照你所运行的
harness 对应的说明操作，包括最后的验证步骤。如果你卡住了，告诉我文档在哪里与你实际发现的情况
不符。

如果你无法获取该仓库（TLS 被阻止 —— 例如 SEC_E_NO_CREDENTIALS、schannel 错误、curl
退出码 35），请改用 git -c http.sslBackend=openssl clone --depth 1 https://github.com/bolloplayer/affinity-mcp-setup.git
或 SETUP.md 顶部的 Node 一行命令，而不是去调试连接。

就这样。你的代理会阅读 SETUP.md，注册连接，在不触碰你任何东西的情况下证明它
可以工作 —— 然后给你提供一个简短的菜单：就此打住、对你打开的照片运行色彩增强并查看前后对比、
编写你自己的风格，或者让该连接在整台机器范围内生效。

⚠️ 预期会有一次重启 —— 这不是失败

进行到一半时，你的代理会停下来并要求你重启它。这是预期之内的。

这些工具中的每一个都只在启动时加载一次其 MCP 配置。代理刚刚写入了该配置，
所以连接不可能在创建它的那个会话中存在 —— 在它们中的任何一个里，都没有可以实时加载它的命令。

退出，在同一文件夹中重新启动它，如果被提示就批准 affinity 服务器，然后说
“continue”。你的代理会给自己留一条笔记，因此新会话会从它停止的地方继续，
直接进入前后对比。

对于这个文件夹来说只有一次。 而且一旦你看到它正常工作，你的代理会提议在整台机器范围内注册
Affinity，这样你在任何项目中都不必再做设置。

更愿意手动操作？SETUP.md 作为一份人类文档读起来也完全没问题。

连接，一行搞定

端点始终是：

http://[::1]:6767/sse

| Harness | 配置文件 | 传输方式 |
|---|---|---|
| Claude Code — CLI、VS Code、Desktop Code 标签页 | 项目中的 .mcp.json | SSE 原生 |
| Codex — CLI、ChatGPT Codex 标签页 | ~/.codex/config.toml | stdio bridge → SSE |
| Antigravity（agy）— Gemini | ~/.gemini/config/mcp_config.json — 全局（serverUrl） | SSE 原生 |
| OpenCode — 任意模型 | 项目中的 opencode.json — 工作区（url） | SSE 原生 |
| DeepSeek Harness（DSH）— Web UI | 项目中的 cordis.yml — 工作区 | stdio bridge → SSE |

有三件事看起来像 bug，但其实不是：必须是 [::1]，绝不能用 localhost 或 127.0.0.1
（Affinity 仅绑定 IPv6 回环地址）；必须是 仅 SSE（不存在 Streamable HTTP 端点）；并且
Affinity 只接受 MCP 协议 2025-11-25，这就是 Codex 需要 bridge 的原因。
SETUP.md 中有完整列表和原因说明。

这里有什么

| | |
|---|---|
| SETUP.md | 说明文档 — 各 harness 的配置、不要“修复”的规则、验证步骤、故障排查 |
| examples/ | 一个只读连接检查，以及一个可应用于任意照片的两层 Color Boost |
| bridge/ | Codex 协议 bridge，以及它的冒烟测试 |
| verify.ps1 | 在开始前检查管道 — Affinity 正在运行、端口正在监听、握手 |
| docs/sdk-notes.md | 已确认的 SDK 行为以及已探明的死胡同 |

教程

如需带截图的人工讲解 — Claude Code 路径的端到端流程，以及如何在不更改任何配置文件的情况下
将 Claude Code 指向 DeepSeek：

→ bolloplayer.github.io/affinity-mcp-setup

如果你还没有选择模型或 harness，
docs/tips-choose-your-ai.md 是简短版本 — 该选哪一个、
各自成本如何，以及哪些行不通。

Color Boost 调整图层的前后对比

状态

已在 Windows 11 上使用 Affinity Photo 3.2.x 验证：Claude Code（CLI 和 VS Code）、Codex CLI 和
ChatGPT Codex 标签页、Antigravity、DeepSeek Harness 以及 OpenCode 都能连接、读取 SDK 前言并执行脚本。
Affinity 在 macOS 上暴露相同的服务器，但这里仅验证了 Windows。

Affinity 的 AI Connector 是免费测试版，且归 Canva 所有；其 API 和脚本 SDK 可能会
在不另行通知的情况下发生变化。

许可证

MIT — 见 LICENSE。基于 Affinity Photo 内置 MCP 服务器（Affinity /
Canva）构建。独立项目，不隶属于 Canva 或 Affinity，也未获得其认可。