Anytype MCP Server

官方

让 AI 助手通过自然语言管理 Anytype 加密知识库的官方 MCP 服务器。

分类: 团队协作第 2 / 55
Stars: ★ 537 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · Bun
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 29 天前

64FMRS · C

Anytype MCP Server 是 Anytype 官方维护的 MCP 服务器，把 Anytype 的 OpenAPI 规范转换为 MCP 工具，让 AI 助手能够以自然语言管理加密、本地、可协作的 wiki。它通过 npm 以 stdio 方式运行，配置简单，需要 API 密钥与本地 Anytype 服务，适合已有 Anytype 使用习惯并希望接入 AI 的工作流。

最强项 · 安装易用性 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

11/20

维护活跃度

14/20

文档质量

14/20

安装易用性

15/20

查看各项评分依据

可靠性 10/20: 来源仅含README、server.json清单与仓库元数据，未提供任何源码文件、package.json、测试或CI工作流；虽给出npm包名、1.0.7版本号与stdio传输声明，但无committed tests且无CI可验证MCP初始化与工具列表握手是否成功，按静态校准规则可靠性不得超过12分。服务器宣称通过解析Anytype OpenAPI规范自动生成MCP工具（全局/空间搜索、空间与成员、对象与列表、属性与标签、类型与模板），这类动态生成工具在未见到生成逻辑与错误映射代码时，参数校验、失败诊断与依赖行为均不可控；另存在26个未关闭issue也暗示边缘路径可能有缺陷。故给10分：主路径看似可用，但缺测试证据、错误处理与依赖边界不透明。
安全与权限 11/20: 凭据处理方面，OPENAPI_MCP_HEADERS被标记为is_secret且必填，README要求以JSON字符串形式传入Bearer API Key，这属于把密钥直接写入客户端配置文件的常见但不理想做法，无操作系统密钥链或加密存储支持；不过key本身由Anytype本地应用生成、服务默认连接http://127.0.0.1:31009本地端点，数据边界基本停留在本机，外部网络暴露有限，且未发现恶意行为、隐蔽外传、伪造维护者或示例含真实token等红线。扣分点在于：工具描述中没有任何危险操作（删除对象/空间、成员变更、批量修改）的显式确认或dry-run机制披露，权限范围与最小权限说明缺失，ANYTYPE_API_BASE_URL可将流量指向任意主机但没有对此的安全提示。故给11分：主要风险可见、无红线段，但权限界定与确认机制不完整。
维护活跃度 14/20: 有明确组织归属（Anytype/anyproto，瑞士协会）与MIT许可证，README提供[email protected]安全响应渠道并链接行为准则与贡献指南，server.json显示1.0.7版本且状态active，npm包持续发布，说明维护链条基本健全。扣分点：未提供提交频率、发布时间线、依赖更新策略或支持周期，26个未关闭issue是否被响应无证据；治理与版本演进路径仅靠推断。故给14分：许可、归属与安全通道清晰，但版本化与治理细节存在缺口。
文档质量 14/20: 文档分层较好：安装（npx/全局安装/claude mcp add）、获取API Key的两种方式（应用内与CLI）、多客户端配置片段（Claude Desktop、Cursor、Windsurf、Raycast、LM Studio、Kiro）、自定义API Base URL与端口说明（31009/31012）以及自然语言交互示例一应俱全，属于可直接照抄的水平。扣分点：完全没有工具清单与各工具的参数说明、返回结构、分页或速率限制、成本说明与故障排查章节；OpenAPI派生工具的具体集合与命名规则未披露，用户无法预判AI会调用哪些能力；错误信息形式也未文档化。故给14分：可上手但存在隐藏假设与故障排查空白。
安装易用性 15/20: 安装路径清晰且步骤少：一条npx -y @anyproto/anytype-mcp即可运行，文档给出主流客户端JSON配置与Claude Code CLI单命令添加方式，并提供多个一键安装deeplink，普通用户按提示替换API Key即可完成连接，本文未发现任何令牌泄露。扣分点：仍依赖外部Anytype桌面应用先开启本地API与生成密钥，默认本地端口与anytype-cli端口差异需手动配置ANYTYPE_API_BASE_URL；未说明Node/Bun运行时版本要求、Windows/macOS/Linux兼容性差异与排查步骤（from-source构建需Bun，对新手是额外门槛）。按静态校准规则，无真实CI与测试证据时setup不得超过15分。故给15分：配置示例完善、路径明确，但存在外部依赖与自动化验证缺失。

静态评测 · 未实际运行收录于 2026-09-18

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

已将 Anytype 作为个人或协作知识库使用的用户
希望通过自然语言快速创建与管理 Anytype 对象的用户
在本地运行 Anytype 桌面端并希望接入 AI 助手的高级用户

不适合谁

未安装或未运行 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 指向不可信地址时，认证头可能被发送到该地址

安装接入

准备工作

运行环境：Node.js · Bun

OPENAPI_MCP_HEADERS 必填密钥包含 Authorization Bearer <YOUR_API_KEY> 和 Anytype-Version: 2025-11-08 的 JSON 字符串；API key 在 Anytype 应用的设置 > API Keys 中创建。

其他可选配置项（1 个）

ANYTYPE_API_BASE_URL 可选可选；默认为 http://127.0.0.1:31009，使用 anytype-cli（端口 31012）或其他自定义地址时设置。

获取 API 密钥：打开 Anytype，进入应用设置（App Settings），打开 API Keys 部分，点击 Create new。也可通过命令行获取：npx -y @anyproto/anytype-mcp get-key。
在 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> 替换为实际密钥。
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。
如需自定义 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\"}"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "anytype": {
      "command": "npx",
      "args": [
        "-y",
        "@anyproto/anytype-mcp"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add anytype -e 'OPENAPI_MCP_HEADERS={"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}' -- npx -y @anyproto/anytype-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端配置中填入 OPENAPI_MCP_HEADERS 后启动，客户端工具列表应出现 anytype 服务器提供的工具（如空间与对象管理相关工具）；也可运行 npx -y @anyproto/anytype-mcp get-key 确认包可用并获取 API key。

常见排障

确认 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 部分重新复制官方提供的即用配置片段以避免手写错误

试试这样问

连接成功后，可以直接对 AI 助手这样说：

创建一个名为 Project Ideas 的新空间，描述为'存放项目想法的空间'
在 Project Ideas 空间中添加一个类型为 Task、标题为 Research AI trends 的新对象
创建一个标题为 Tasks for this week 的合集，并把两个任务加进去
搜索我所有空间中与 LLM 相关的对象

使用场景

创建带标题和描述的新空间，例如创建名为 'Project Ideas' 的空间

在指定空间内创建任务等类型的对象

为任务设置截止日期并分配负责人

创建集合（collection）并将已有任务加入其中

通过对话管理知识库中的对象、列表、属性、标签、类型与模板

支持客户端

Claude Desktop

Cursor

Windsurf

Raycast

Claude Code

LM Studio

Kiro

依据项目文档列出，未经本站实测。

详细介绍

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 端口）。