Agent Skills
返回列表
🤖

AFFiNE MCP 工作空间代理

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents

技能介绍

要解决的问题

很多团队把 AFFiNE 当作本地文档与知识库工具，但一旦 Agent 需要读写工作空间里的内容，常见做法是让人类回到 AFFiNE 的 UI 里手动操作。这条路有两个明显的断点：Agent 无法直接拿到文档结构与数据库条目，自动化流程在中间就断了；不同 MCP 客户端（如 Claude Code、Cursor）各自实现一套集成，导致行为不一致、维护成本重复。

技能如何工作

这个技能通过一个 MCP 兼容的服务端把 AFFiNE 的几类核心资源暴露成可被工具调用的接口：工作空间、文档、数据库与评论。Agent 发起工具调用时，服务端负责与 AFFiNE 后端通信，把请求映射成对应的读写操作，再把结果以 MCP 标准格式返回。

关键步骤大致是：

  • 在客户端配置中指向 AFFiNE 实例，并通过 API token 完成鉴权
  • 客户端启动时连接 stdio 或 HTTP 模式的 MCP 服务端
  • Agent 在对话中发出工具调用请求，服务端路由到 AFFiNE 对应资源
  • 返回结果以统一的 JSON-RPC 结构送回，客户端继续执行后续逻辑

部署侧提供了 Docker 镜像、健康探针与端到端测试覆盖，便于在生产环境里做可观测性与回归验证。

适用边界与注意点

  • AFFiNE Cloud 强制使用 API token 鉴权，邮箱密码登录方式被 Cloudflare 拦截，因此无法用程序化登录绕过
  • 自托管实例同样需要正确配置凭据或令牌
  • 需要 Node.js 环境与支持 MCP 协议的客户端
  • 远程部署时可走 HTTP 或 OAuth，但这部分配置位于单独的文档中，不在基础用法范围内

使用场景

  • 数据分析师需从AFFiNE数据库中提取销售数据用于报表，通过MCP服务直接调用避免手动导出
  • 文档工程师批量生成技术文档并自动发布到AFFiNE工作空间，确保版本统一
  • 客服机器人需读取AFFiNE文档中的FAQ条目并回复用户提问，通过评论接口更新答案
  • 运维人员通过MCP监控AFFiNE服务健康状态，当数据库连接异常时自动触发告警

适合人员

  • 后端开发者需要将AFFiNE集成到现有系统，为Agent提供工作空间和文档操作能力
  • DevOps工程师希望用Docker部署AFFiNE MCP服务端并配置健康探针
  • 数据工程师需要构建自动化工作流，从AFFiNE数据库提取数据并生成报告
  • AI应用开发者在Claude Code或Cursor中调用AFFiNE工具完成复杂任务