# MoonLink MCP · MoonlyBox

**MoonLink** is the official MCP (Model Context Protocol) server of [MoonlyBox](https://moonlybox.cn) — an AI-native personal knowledge workspace (bookmarks · sticky notes · todos · Study knowledge base · AI memory).

**月光链**是[魔力宝盒](https://moonlybox.cn)的官方 MCP 服务器：AI 对话即采集——收藏网页、存便签、建待办、写书房文档、提取网页存档，并检索个人知识与记忆。云端托管，跨 Claude / Cursor / Cherry Studio / Copilot 等客户端共享同一份个人记忆。

> **Open spec, hosted service** · 规范开放，服务闭源：this repository contains the *integration spec & behavior template* only. The hosted service is proprietary.

## Connect / 接入

**Endpoint 端点**：`https://moonlybox.cn/mcp` (Streamable HTTP)

**Auth 认证**（二选一）：
- **OAuth** — keyless browser authorization, supported by Claude Desktop / Cherry Studio / CodeBuddy
- **PAT** — header `Authorization: Bearer mk_...` (issue at 站内「AI 托管」页签 → 月光链)

**Quick start 快速开始**：
1. Sign up at https://moonlybox.cn (email registration supported / 支持邮箱注册)
2. Open 「AI 托管」→ 月光链 → issue a PAT / or use OAuth in your client
3. Add to your client:

```json
{
  "mcpServers": {
    "moonlink": {
      "url": "https://moonlybox.cn/mcp",
      "headers": { "Authorization": "Bearer mk_..." }
    }
  }
}
```

## Tools / 工具（24）

See [docs/tools.md](docs/tools.md) for the full table. Highlights:
- **Capture 采集**: add_bookmark · add_sticky · add_todo · save_note · extract_archive · add_memory
- **Query 检索**: search_bookmarks · search_library · search_topics · search_memory · list_stickies · list_todos · list_goals · list_library_index · raw_get
- **Organize 整理**: update_bookmark · update_sticky · update_todo · convert_todo_to_sticky
- **Delete（soft, 72h restore for bookmarks）**: delete_bookmark · delete_sticky · delete_todo · restore_bookmark

## Agent behavior template / 行为规范

[docs/agentsTemplate.md](docs/agentsTemplate.md) — the canonical "Agents.md" template telling AI clients **when & how** to use these tools (silent memory whitelist, query-first, deletion confirmation discipline). Drop it into your client as `AGENTS.md` / `CLAUDE.md`.

## Docs / 文档

| Doc | Content |
| --- | --- |
| [docs/tools.md](docs/tools.md) | Full tool table with schemas hints |
| [docs/agentsTemplate.md](docs/agentsTemplate.md) | AI behavior template (AGENTS.md source) |
| [docs/oauth-setup.md](docs/oauth-setup.md) | OAuth 2.1 / DCR client setup |
| [docs/pat.md](docs/pat.md) | Personal Access Token (PAT) guide |

## License / 许可

- Integration docs & template: **CC BY 4.0**
- The hosted MoonLink service & MoonlyBox platform: **Proprietary** (see [NOTICE](NOTICE))

## Contact / 联系

- Support & review: support@moonlybox.cn
- Open-source & community: open@moonlybox.cn
- Privacy policy: https://moonlybox.cn/privacy