DEVONthink

Devonthink MCP 服务

该 MCP 服务通过模型上下文协议（MCP）提供对 DEVONthink 功能的访问。它支持在 macOS 上的 DEVONthink Pro 中列出、搜索、创建、修改和管理记录与数据库。

功能

• 将一整套 DEVONthink 操作作为 MCP 工具公开
• 按各种属性列出、搜索和查找记录
• 创建、删除、移动和重命名记录与分组
• 获取并修改记录内容、属性和标签
• 从 URL 以多种格式创建记录
• 列出打开的数据库和分组内容
• 所有工具均为类型安全，并使用 Zod schema 进行校验

工具

核心工具

1. is_running

   • 检查 DEVONthink 当前是否正在运行
   • 无需输入
   • 返回：{ "success": true | false }

2. create_record

   • 创建具有指定属性的新记录（笔记、书签、分组）
   • 输入：记录类型、名称、父分组以及可选元数据

3. delete_record

   • 按 ID、名称或路径删除记录
   • 输入：记录标识符

4. move_record

   • 在分组之间移动记录
   • 输入：记录 ID 和目标分组

5. get_record_properties

   • 获取记录的详细元数据和属性
   • 输入：记录标识符

6. search

   • 执行基于文本的搜索，并提供多种比较选项
   • 输入：查询字符串和搜索选项

7. lookup_record

   • 按文件名、路径、URL、标签、评论或内容哈希查找记录（仅精确匹配）
   • 输入：查找类型和值

8. create_from_url

   • 从 Web URL 以多种格式创建记录
   • 输入：URL 和格式选项

9. get_open_databases

   • 列出所有当前打开的数据库
   • 无需输入

10. list_group_content

    • 列出特定分组的内容
    • 输入：分组标识符

11. get_record_content

    • 获取特定记录的内容
    • 输入：记录标识符

12. rename_record

    • 重命名特定记录
    • 输入：记录 ID 和新名称

13. add_tags

    • 向特定记录添加标签
    • 输入：记录 ID 和标签

14. remove_tags

    • 从特定记录移除标签
    • 输入：记录 ID 和标签

15. classify

    • 使用 DEVONthink 的 AI 获取记录的分类建议
    • 输入：记录 UUID、可选数据库名称、比较类型和标签选项
    • 返回：带有分数的分类建议数组（分组或标签）

16. compare

    • 比较记录以查找相似之处（混合方法）
    • 输入：主记录 UUID、可选的第二记录 UUID、数据库名称和比较类型
    • 返回：相似记录（单条模式）或详细比较分析（双记录模式）

示例：搜索工具

{
  "query": "project plan",
  "comparison": "contains",
  "database": "Inbox"
}

返回：

{
  "results": [
    { "id": "123", "name": "Project Plan", "path": "/Inbox/Project Plan.md" }
  ]
}

与 Claude 配合使用

添加到你的 Claude 配置中：

{
  "mcpServers": {
    "devonthink": {
      "command": "npx",
      "args": ["-y", "mcp-server-devonthink"]
    }
  }
}

实现细节

• 使用 JXA（JavaScript for Automation）通过 AppleScript API 控制 DEVONthink
• 所有工具输入均使用 Zod schema 进行校验，以确保安全性和清晰性
• 所有工具输出均返回结构化 JSON
• 为所有操作实现稳健的错误处理
• 包含使用 Vitest 的全面测试

有关完整文档、工具开发指南和 API 参考，请参见 CLAUDE.md。