Devonthink MCP Server

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

功能

• 将一系列全面的DEVONthink操作作为MCP工具公开
• 根据各种属性列出、搜索和查找记录
• 创建、删除、移动和重命名记录及组
• 获取并修改记录内容、属性和标签
• 从多个格式的URL创建记录
• 列出打开的数据库和组内容
• 所有工具都是类型安全的，并使用Zod模式进行验证

工具

核心工具

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": "项目计划",
  "comparison": "包含",
  "database": "收件箱"
}

返回：

{
  "结果": [
    { "id": "123", "名称": "项目计划", "路径": "/收件箱/项目计划.md" }
  ]
}

使用Claude

添加到您的Claude配置：

{
  "mcpServers": {
    "devonthink": {
      "命令": "npx",
      "参数": ["-y", "mcp-server-devonthink"]
    }
  }
}

实现细节

• 使用JXA（用于自动化的JavaScript）通过AppleScript API控制DEVONthink
• 所有工具输入都使用Zod模式进行验证，确保安全性和清晰度
• 所有工具输出返回结构化JSON
• 对所有操作实现健壮的错误处理
• 使用Vitest进行全面测试

参见CLAUDE.md获取完整文档、工具开发指南和API参考。