Anytype MCP

官方 Anytype MCP 已在此发布

https://github.com/anyproto/anytype-mcp

Anytype MCP 服务

一个 MCP（Model Context Protocol）服务，可访问 Anytype API，让 AI 助手和其他 MCP 客户端能够与您的 Anytype 数据交互。

基于 Anytype API 定义 v0.46+（2025-03-17）。 请确保您的 Anytype 桌面版兼容。

功能

• 获取空间列表（get_spaces）
• 在空间内搜索／获取对象（get_objects、search_space），或进行全局搜索（global_search）
• 获取对象的详细内容（get_object_content，支持获取全文）
• 创建和删除空间（create_space）及对象（create_object、delete_object）
• 将对象导出为 Markdown（export_object）
• 管理列表视图及列表中的对象（get_list_views、get_list_view_objects、add_objects_to_list、remove_object_from_list）
• 获取空间成员（get_space_members）
• 获取类型和模板（get_types、get_type_details、get_templates、get_template_details）

前提条件

• Node.js 18 或更高版本
• 本地运行的 Anytype 桌面应用
• Anytype 帐户

安装

手动安装

1. 克隆此仓库：

   git clone https://github.com/Qwinty/anytype-mcp.git
   cd anytype-mcp
   

2. 安装依赖项：

   npm install
   

3. 构建项目（将 TypeScript 编译为 build/ 中的 JavaScript）：

   npm run build
   

4. 获取 App Key： 配置服务前，您需要从 Anytype 获取 App Key。请参阅下方的“获取 App Key”部分。

5. 将 MCP 服务添加到 MCP 配置文件

获取 App Key

使用 MCP 服务前，您需要从 Anytype 桌面应用获取 App Key：

1. 确保 Anytype 桌面应用正在运行

2. 运行辅助脚本：

   npm run get-key
   

3. 按照说明授权应用

4. 记下用于配置的 App Key

配置

将 Anytype MCP 服务添加到 MCP 配置文件：

• 对于 Claude：编辑 claude_desktop_config.json
• 对于其他 MCP 客户端：编辑相应的配置文件

配置示例：

{
  "mcpServers": {
    "anytype": {
      "command": "node",
      "args": ["{path/to/anytype-mcp}/build/index.js"],
      "env": {
        "ANYTYPE_APP_KEY": "YOUR_APP_KEY_HERE"
      },
      "disabled": false
    }
  }
}

将 path/to/anytype-mcp 替换为实际安装路径，并将 YOUR_APP_KEY_HERE 替换为您获取的 App Key。

使用

启动服务

MCP 服务通常由 MCP 客户端自动启动。不过，您也可以手动启动以进行测试：

npm start

可用工具

请参阅 Tools.md，了解可用工具的详细列表及使用示例。

系统提示词

此外，docs/system-prompt.md 中提供了供使用此服务的 AI 助手使用的系统提示词示例。

令牌效率与数据筛选

为优化 AI 助手的令牌使用效率，此 MCP 服务默认会筛选返回对象数据的工具（get_objects、global_search、search_space）的响应。

• 默认行为： 服务会返回简化版对象数据，包括 ID、名称、类型、图标、布局、空间 ID、根 ID、摘要（如有）、块数量、标签、创建／修改日期和创建者信息。完整的块内容和详细关系会被省略。
• include_text: true： 多个工具（get_objects、get_object_content、global_search、search_space）支持可选参数 include_text。设为 true 后，服务会提取对象块中的完整格式化文本内容，并将其纳入 full_text 字段。需要完整文本时可使用此参数，但请注意，这会显著增大响应和令牌数量。
• full_response: true： get_objects、global_search 和 search_space 工具也支持 full_response 参数。设为 true 后会绕过所有筛选，直接返回 Anytype API 的原始完整 JSON 响应。此选项提供最详细的信息，但消耗的令牌也最多。

请根据需要的是元数据、完整文本内容还是完整的原始 API 响应，选择合适的参数。

故障排除

Anytype API 无响应

请确保电脑上正在运行 Anytype 桌面应用。MCP 服务会连接到本地 Anytype API：http://localhost:31009/v1。

身份验证问题

如果遇到身份验证错误：

1. 运行 npm run get-key 获取新的应用密钥
2. 使用新密钥更新 MCP 配置
3. 重启 MCP 客户端

本地 API 端口

默认情况下，服务会连接到 http://localhost:31009/v1 上的 Anytype API。如果 Anytype 安装使用了其他端口，则目前需要修改 src/index.ts 中的 apiBaseUrl 变量，并重新构建（npm run build）。未来可以考虑通过环境变量进行配置。

许可证

MIT