affine-mcp-server

概述

affine-mcp-server 是一个结构良好的 MCP 服务器，使 AI 助手能够与 AFFiNE 工作区交互。它通过稳定的 API 表面提供对文档、数据库、协作功能和组织工具的全面访问。该服务器支持 stdio 和 HTTP 传输，具有强大的身份验证选项，包括 AFFiNE 云和自托管实例的令牌、Cookie 和电子邮件/密码。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• create_workspace

  Create a new workspace in AFFiNE

  试试:Create a new workspace for my project试试:Set up a workspace called 'Meeting Notes'
• search_documents

  Search for documents across workspaces

  试试:Find all documents about project planning试试:Search for documents containing the term 'Q3 results'
• read_document

  Read the content of a specific document

  试试:Show me the content of document ID 123试试:Read the document titled 'Annual Report'
• create_document

  Create a new document in a workspace

  试试:Create a new document called 'Project Ideas'试试:Start a new meeting notes document
• create_database_column

  Add a new column to a database

  试试:Add a 'Priority' column to the tasks database试试:Create a 'Due Date' column in my project tracker
• add_database_row

  Add a new row to a database

  试试:Add a new task to the database试试:Create a row for the project milestone in the tracker
• list_comments

  List all comments on a document

  试试:Show me all comments on the design document试试:List comments on the budget proposal
• create_comment

  Add a comment to a document

  试试:Add a comment about the timeline试试:Comment on the section about budget
• get_user_info

  Retrieve information about the current user

  试试:Show my user profile试试:Get my account information
• upload_blob

  Upload a file/blob to AFFiNE storage

  试试:Upload the presentation PDF试试:Add the design mockup to the workspace
• list_notifications

  Get all notifications for the current user

  试试:Show me my notifications试试:List all unread notifications
• publish_document

  Publish a document to make it publicly accessible

  试试:Publish the company handbook试试:Make the project documentation public

说明：Tool names inferred from the Tool Surface section which lists domains but doesn't provide explicit tool names. The actual tool names would be defined in tool-manifest.json.

可对比工具

安装

npm i -g affine-mcp-server
affine-mcp --version

npx -y -p affine-mcp-server affine-mcp -- --version

docker run -d 
  -p 3000:3000 
  -e MCP_TRANSPORT=http 
  -e AFFINE_BASE_URL=https://your-affine-instance.com 
  -e AFFINE_API_TOKEN=ut_your_token 
  -e AFFINE_MCP_AUTH_MODE=bearer 
  -e AFFINE_MCP_HTTP_TOKEN=your-strong-secret 
  ghcr.io/dawncr0w/affine-mcp-server:latest

{
  "mcpServers": {
    "affine": {
      "command": "affine-mcp"
    }
  }
}

FAQ

支持哪些身份验证方法？

该服务器支持 AFFiNE 云和自托管实例的令牌、Cookie 和电子邮件/密码身份验证。建议在生产环境中使用 API 令牌。

我可以限制暴露哪些工具吗？

是的，您可以使用 AFFINE_TOOL_PROFILE（read_only、core、authoring）或 AFFINE_DISABLED_GROUPS 等环境变量来限制最小权限部署的工具暴露。

affine-mcp-server 对比