MCP
# MCP(给其他 Agent) 本仓库提供 **MCP Server**,与 REST API 共用同一套 `PageService`(Postgres + 文件卷)。 ## 运行方式 | 方式 | 用途 | |------|------| | **stdio**(默认) | Cursor / Claude Desktop 以子进程拉起 | | **HTTP** | 远程 Agent,`MCP_HTTP_ADDR=:8090` | ```bash cp .env.example .env go build -o build/mcp.exe ./cmd/mcp go run ./cmd/mcp ``` HTTP:`set MCP_HTTP_ADDR=:8090` 后 `go run ./cmd/mcp` ## Cursor 配置 参考仓库 `docs/cursor-mcp.json.example`,在 Cursor MCP 设置里配置 `command` 指向 `build/mcp.exe`,`env` 与 Web 相同(`DATABASE_URL`、`PAGES_DATA`、`BASE_URL` 等)。 ## 鉴权 写操作须先 **`auth_login`**,将返回的 **`token`** 填入后续写工具的 **`auth_token`**。 REST 写接口:`Authorization: Bearer <token>` 或登录 Cookie。 ## Tools | Tool | 说明 | |------|------| | `auth_login` | 登录拿 token | | `pages_search` | 全文/列表 | | `pages_get` | 单条元数据 | | `pages_create` | title + zip_base64 | | `pages_patch` | 改元数据 | | `pages_replace_content` | 覆盖 zip | | `pages_publish` / `pages_unpublish` | 状态 | | `pages_delete` | 硬删 | 大文件上传更建议 REST `POST /api/v1/pages`。