使用说明
Devonsthink MCP服务器
此MCP服务器通过模型上下文协议（MCP）提供对DEVONthink功能的访问。它允许在macOS上的DEVONthink Pro中列出、搜索、创建、修改和管理记录和数据库。
特性
- 将一套全面的DEVONthink操作作为MCP工具公开
- 按各种属性列出、搜索和查找记录
- 创建、删除、移动和重命名记录和组
- 检索和修改记录内容、属性和标记
- 从多种格式的URL创建记录
- 列出打开的数据库和组内容
- 所有工具都是类型安全的，并使用Zod模式进行验证
工具
核心工具
-
is_running- 检查DEVONthink当前是否正在运行
- 无需输入
- 退货：
{ "success": true | false }
-
create_record- 创建具有指定属性的新记录（笔记、书签、组）
- 输入：记录类型、名称、父组和可选元数据
-
delete_record- 按ID、名称或路径删除记录
- 输入：记录标识符
-
move_record- 在组之间移动记录
- 输入：记录ID和目标组
-
get_record_properties- 检索记录的详细元数据和属性
- 输入：记录标识符
-
search- 使用各种比较选项执行基于文本的搜索
- 输入：查询字符串和搜索选项
-
lookup_record- 按文件名、路径、URL、标签、注释或内容哈希查找记录（仅精确匹配）
- 输入：查找类型和值
-
create_from_url- 从多种格式的web URL创建记录
- 输入：URL和格式选项
-
get_open_databases- 列出当前打开的所有数据库
- 无需输入
-
list_group_content- 列出特定组的内容
- 输入：组标识符
-
get_record_content- 检索特定记录的内容
- 输入：记录标识符
-
rename_record- 重命名特定记录
- 输入：记录ID和新名称
-
add_tags- 为特定记录添加标签
- 输入：记录ID和标签
-
remove_tags- 从特定记录中删除标记
- 输入：记录ID和标签
-
classify- 使用DEVONthink的AI获取记录的分类建议
- 输入：记录UUID、可选数据库名称、比较类型和标签选项
- 返回：带有分数的分类建议（组或标签）数组
-
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模式进行验证，以确保安全性和清晰度
- 返回所有工具输出的结构化JSON
- 对所有操作实施稳健的错误处理
- 包括使用Vitest的全面测试
看 CLAUDE.md 获取完整的文档、工具开发指南和API参考资料。
