适合谁
- 已将 Anytype 作为个人或协作知识库使用的用户
- 希望通过自然语言快速创建与管理 Anytype 对象的用户
- 在本地运行 Anytype 桌面端并希望接入 AI 助手的高级用户
A
64FMRS · C
Anytype MCP Server 是 Anytype 官方维护的 MCP 服务器，把 Anytype 的 OpenAPI 规范转换为 MCP 工具，让 AI 助手能够以自然语言管理加密、本地、可协作的 wiki。它通过 npm 以 stdio 方式运行，配置简单，需要 API 密钥与本地 Anytype 服务，适合已有 Anytype 使用习惯并希望接入 AI 的工作流。
Anytype MCP Server 是 Anytype 官方的模型上下文协议（MCP）服务器，将 Anytype 的 OpenAPI 规范转换为 MCP 工具，使 AI 助手能够通过自然语言与 Anytype API 交互，管理你的加密、本地且可协作的 wiki。它提供全局与空间搜索、空间与成员、对象与列表、属性与标签、类型与模板等能力。该服务器以 stdio 方式运行，通过 npm 包 @anyproto/anytype-mcp 分发，需要提供包含 Anytype API 认证信息的 OPENAPI_MCP_HEADERS 环境变量；默认连接 http://127.0.0.1:31009，可通过 ANYTYPE_API_BASE_URL 自定义（例如 anytype-cli 使用 31012 端口）。
安装接入
- 获取 API 密钥：打开 Anytype，进入应用设置（App Settings），打开 API Keys 部分，点击 Create new。也可通过命令行获取：npx -y @anyproto/anytype-mcp get-key。2. 在 MCP 客户端（Claude Desktop、Cursor、Windsurf、Raycast 等）配置中加入：{"mcpServers":{"anytype":{"command":"npx","args":["-y","@anyproto/anytype-mcp"],"env":{"OPENAPI_MCP_HEADERS":"{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"}}}}，将 <YOUR_API_KEY> 替换为实际密钥。3. Claude Code（CLI）可执行：claude mcp add anytype -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}' -s user -- npx -y @anyproto/anytype-mcp。4. 如需自定义 API 地址（例如 anytype-cli 的 31012 端口），设置 ANYTYPE_API_BASE_URL。也可先执行 npm install -g @anyproto/anytype-mcp 全局安装，再用命令 anytype-mcp 启动。
claude_desktop_config.json
{"mcpServers":{"anytype":{"command":"npx","args":["-y","@anyproto/anytype-mcp"],"env":{"OPENAPI_MCP_HEADERS":"{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"}}}}
选型与风险
不适合谁
- 未安装或未运行 Anytype、无法获取 API 密钥的用户
- 需要远程托管服务而非本地 stdio 进程的场景
- 希望无需配置环境变量即可直接使用的用户
所需权限
- 需要 Anytype API 密钥（通过 Authorization: Bearer 头传递）
- 需要访问本地 Anytype API 服务（默认 http://127.0.0.1:31009）
- 通过 OPENAPI_MCP_HEADERS 环境变量传递认证头，该值被视为机密
- 在本地以 stdio 子进程方式运行 npx 命令
风险与副作用
- OPENAPI_MCP_HEADERS 中包含 API 密钥，若配置泄露可能导致他人访问你的 Anytype 数据
- 服务器可代表密钥所有者创建和修改空间、对象、列表等数据
- 运行 npx -y 会从 npm 拉取并执行包代码
- 自定义 ANYTYPE_API_BASE_URL 指向不可信地址时，认证头可能被发送到该地址
常见排障
- 确认 Anytype 应用正在运行且 API 服务可访问（默认 127.0.0.1:31009）
- 检查 OPENAPI_MCP_HEADERS 是否为合法 JSON 字符串且密钥正确
- 若使用 anytype-cli（31012 端口）或其他地址，确认已设置 ANYTYPE_API_BASE_URL
- 确认 Anytype-Version 头与目标 API 版本匹配（示例为 2025-11-08）
- 在 Anytype 的 API Keys 部分重新复制官方提供的即用配置片段以避免手写错误
使用场景
创建带标题和描述的新空间，例如创建名为 'Project Ideas' 的空间
在指定空间内创建任务等类型的对象
为任务设置截止日期并分配负责人
创建集合（collection）并将已有任务加入其中
通过对话管理知识库中的对象、列表、属性、标签、类型与模板
支持客户端
Claude Desktop完整支持
Cursor完整支持
Windsurf完整支持
Raycast完整支持
Claude Code完整支持
LM Studio完整支持
Kiro完整支持