# Canvas AIGC

Canvas AIGC 是连接网页画布与本机 Codex / Claude 的 MCP 服务。它通过本地 HTTP 桥接按浏览器会话隔离画布状态，并通过 stdio MCP 暴露读取、创建、修改、连线、生成和素材管理等 36 个工具。

## 环境要求

- Node.js 18 或更高版本
- 已安装并登录 Codex CLI，或已配置 Claude Agent SDK 所需凭据
- 本地 Infinite Canvas 默认运行在 `http://localhost:3000`

## 快速启动

直接启动本地桥接服务：

```bash
npx -y github:3108482409song-commits/Canvas-AIGC#v0.4.0
```

默认输出：

```text
Canvas AIGC
Local URL: http://127.0.0.1:17371
Connect token: <token>
```

配置保存在 `~/.canvas-aigc/config.json`。服务只监听 `127.0.0.1`，网页必须携带正确 token，首次成功连接后会记录允许访问的网页 Origin。

## Codex MCP

```bash
codex mcp add canvas-aigc -- npx -y github:3108482409song-commits/Canvas-AIGC#v0.4.0 mcp
```

MCP 启动时会自动检测并拉起本地 HTTP 桥接服务，不需要另外启动第二个进程。注册或更新后需要开启新的 Codex 对话加载工具。

也可以在 `~/.codex/config.toml` 中手动配置：

```toml
[mcp_servers.canvas-aigc]
command = "npx"
args = ["-y", "github:3108482409song-commits/Canvas-AIGC#v0.4.0", "mcp"]
startup_timeout_sec = 60
tool_timeout_sec = 90
```

## Claude MCP

```bash
claude mcp add --scope user --transport stdio canvas-aigc -- npx -y github:3108482409song-commits/Canvas-AIGC#v0.4.0 mcp
```

## 主要工具

- `canvas_get_capabilities`、`canvas_list_sessions`、`canvas_use_session`
- `canvas_get_state`、`canvas_get_selection`、`canvas_export_snapshot`
- `canvas_get_nodes`
- `canvas_create_node`、`canvas_create_text_node`、`canvas_create_text_nodes`
- `canvas_create_image_prompt_flow`、`canvas_create_generation_flow`
- `canvas_generate_text`、`canvas_generate_image`、`canvas_generate_video`、`canvas_generate_audio`
- `canvas_update_node`、`canvas_move_nodes`、`canvas_resize_node`
- `canvas_delete_nodes`、`canvas_connect_nodes`、`canvas_select_nodes`
- `canvas_set_viewport`、`canvas_run_generation`、`canvas_apply_ops`
- `canvas_get_generation_status`、`canvas_wait_generation`、`canvas_cancel_generation`
- `site_navigate`、`canvas_list_projects`
- `assets_list`、`assets_get`、`assets_add`、`assets_delete`、`assets_restore`

写入操作仍由网页 Agent 侧边栏按手动或自动模式处理，MCP 不绕过画布确认流程。每次写入都校验目标会话和 revision，批量操作返回逐项结果；不同画布使用独立工作目录和 active thread。生成工具只表示任务已排队，需要通过状态或等待工具取得真实结果；桥接进程重启后使用节点 ID 重新读取状态。

## 本地开发

```bash
npm install
npm run dev
```

源码位于 `src/`，协议层使用官方 `@modelcontextprotocol/sdk`，工具入参使用 `zod` 校验。

## License

AGPL-3.0-only。维护与派生说明见 [NOTICE](NOTICE)。