xfy/yggdrasil
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
yggdrasil/.scratch/mcp-server/issues/T7-verification-docs.md
xfy 9eac025b3e feat(mcp): 完整工具面 + token 管理 + 管理页（T2-T5 并行实现 + 合并） 
T2 token 管理（src/api/mcp_tokens.rs）：create/list/reveal/revoke + get_mcp_client_configs
服务端函数，均经 get_current_admin_user 鉴权；TokenLifetime 枚举（1/7/30/90天/永不过期）。
src/mcp/config.rs 生成 4 种客户端配置（Claude Code/Cursor/Cline/通用 + CLI）。
src/pages/admin/mcp.rs 令牌管理页：列表 + 新建表单 + 一次性明文展示/重查 + 撤销 +
配置片段卡片。路由 /admin/mcp，导航项加入 admin_layout。

T3 read 工具 + Resources（tools/read.rs, resources.rs）：search_posts/get_post/list_tags
（read 作用域，仅已发布）；published-post Resources（post://{slug}，游标分页）。
search_published 提取为共享函数。

T4 write 工具（tools/{posts,comments,tags,media}.rs）：create/update/publish/trash/delete_post、
评论审核、标签 CRUD、媒体 base64 上传（WebP 转码 + 去重）。复用既有 helper 的 SQL 与
缓存失效（moka + ssr_cache）。write 作用域，可读草稿。

T5 admin 工具（tools/{settings,runner}.rs）：get/update_settings、run_code（沙箱执行）。
admin 作用域。

合并（server.rs）：用 rmcp tool_router 的「命名路由 + 组合」模式，7 个工具组在
YggMcpServer 上 impl，combined_router 用 + 合并成单一 ServerHandler。各工具组鉴权
独立，经 Extension<Parts> 读 McpPrincipal + scope.grants 校验。

新增依赖 base64 0.22（媒体上传解码）。验证：server/web 双目标编译通过、clippy
--all-features -D warnings 干净、659 单测 + 1 集成全绿（+20 新测试）。
2026-07-28 11:53:32 +08:00

1.3 KiB
Raw Blame History

T7 — Integration verification + docs

Blocking edges

  • Blocks: nothing (terminal ticket).
  • Blocked by: T2 (UI), T6 (hardening).

Target files

  • docs/CHANGELOG.md, .env.example, AGENTS.md (architecture note), docs/DEPLOYMENT.md.

Change

  1. Manual smoke test against a running instance with a real client (Claude Code preferred, Cursor/Cline as available): mint a read token → connect → search_posts → resources/read; mint a write token → create_post → confirm it appears in the web admin with rendered content_html; mint an admin token → run_code. Confirm invalid token / bad Origin / scope-mismatch are rejected.
  2. Update docs/CHANGELOG.md (Keep a Changelog): feat(mcp): ... entry.
  3. .env.example: document MCP_TOKEN_ENC_KEY + MCP rate-limit vars.
  4. AGENTS.md: add a short MCP section (transport, auth model, scope mapping, the /mcp route, feature-gating note) under the existing architecture structure.
  5. docs/DEPLOYMENT.md: note that /mcp must pass through the reverse proxy and that MCP_TOKEN_ENC_KEY is required for the feature.

Acceptance

  • At least one real client connects end-to-end and exercises read + write + admin paths.
  • All rejection paths confirmed.
  • Docs updated; no plaintext tokens committed anywhere.
  • make lint passes.