← 返回

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`。