Devonthink MCP CLI

DEVONthink MCP&CLI（dt）

devonthink-mcp-cli header

（非官方） macOS上DEVONthink 4的智能桥。

dt 是一个高性能的命令行界面和模型上下文协议（MCP）服务器，它将您的DEVONthink数据库变成人工智能代理和专业自动化的一流公民。

______________________________________________________________________

💡 问题

DEVONthink是macOS上最强大的个人信息管理器，但它在历史上一直是一个“离线堡垒”

1. 脚本差距： AppleScript和JXA功能强大，但执行开销高，现代工作流的学习曲线陡峭。
2. AI隔离： 现代大型语言模型（LLM），如Claude或GPT，如果不进行手动复制粘贴，就无法“看到”您本地的DEVONthink数据库，从而失去了您精心策划的知识的好处。
3. 批量处罚： 通过标准脚本运行数百个单独的命令会由于重复的进程初始化而导致严重的性能滞后。

🚀 解决方案：智能桥梁

dt 通过在本地数据和人工智能代理世界之间提供统一的、状态感知的桥梁来解决这些问题。

项目的演变

• v1.0（命令行界面）： 一个简单的JXA包装器，使基于终端的搜索和记录创建快速且可预测。
• v2.0（MCP服务器）： 添加 模型上下文协议允许AI代理（如Claude Desktop）原生搜索、读取和组织您的数据库，就像它们是AI自身内存的一部分一样。
• v2.2（智能桥）： 介绍 会话状态, 前瞻性批处理，以及 AI驱动的队列修复。系统现在理解 *上下文*，捆绑操作，执行速度提高90%，并可以使用DEVONthink的内部AI自我修复失败的任务。

🧠 为什么是这个项目？（内置AI与。 dt)

DEVONthink 4包括令人印象深刻的内置AI功能，那么为什么要使用 dt?

______________________________________________________________________

MCP服务器配置（Claude、Gemini等）

  "mcpServers": {
    "devonthink": {
      "type": "stdio",
      "command": "path-to-node",
      "args": [
        "path-to/devonthink-cli/bin/dt.js",
        "mcp",
        "run"
      ],
      "env": {
        "DT_DEFAULT_DATABASE": "UUID-OF-YOUR-DATABASE"
      }
    }
  }

🤖 人工智能集成（MCP）

此工具包括 模型上下文协议（MCP） 服务器。当添加到Claude Desktop时，它允许AI：

• 研究： “查找我上个月关于量子计算的所有笔记。”
• 总结： “阅读所选文档，并给我一个3个标题的摘要。”
• 组织： “将这50个PDF移动到正确的文件夹中，并根据其内容对其进行标记。”

👉 安装指南（MCP.md） | 👉 批处理系统指南（docs/Batch-QUEUE.md） | 👉 搜索备忘单（docs/Search-HEATSHEET.md）

______________________________________________________________________

🛠 安装

# Clone or download this repository
cd devonthink-mcp-cli

# Install dependencies
npm install

# Link globally (optional, makes 'dt' available everywhere)
npm link

⚡ 快速开始

# Check if DEVONthink is running
dt status

# Search for records and get clean output
dt search query "machine learning" --database "Research"

# Time-bound search (first-class flags)
dt search query "machine learning" --created-after "2 weeks" --modified-before "2024-12-31"

# Get selected records from the GUI
dt get selection

# Add a task to the queue for later execution
dt move  --to /Archive --queue

# Verify the queue exists and fix errors with AI
dt queue verify
dt queue repair --apply

# Execute the optimized batch
dt queue execute

📖 关键命令

组织与人工智能

• dt organize --auto：一步完成OCR、重命名、标记和汇总记录。
• `dt ocr --output

`：OCR文件并保存在本地（不保存在DEVONthink中）。

• `dt ocr --output

--text`：OCR并将纯文本提取为.txt文件。

• dt ocr -d "Database"：OCR并导入DEVONthink。
• dt summarize ：生成智能摘要（本地或人工智能驱动）。
• dt chat "question"：使用任何AI引擎与您的文档聊天。

管理

• dt search：高速全文、标记、URL或元数据搜索。
• dt get：检索道具、文件路径、数据库路径、文本内容、选择或索引。
• dt create：创建记录、URL标记或AI生成的图像。
• dt download markdown：从web URL创建干净的标记（具有可读性/整理模式）。
• dt tree：将文件夹层次结构显示为ASCII树（用于LLM上下文注入、审核）。
• dt smartgroup：创建、更新、列出和批量操作智能组。
• dt smartgroup delete-items "SG Tag Adult" -d "Test_Database"：删除智能组中的所有项目。
• dt smartgroup modify-items "SG Tag Adult" -d "Test_Database" --add-tag review：批量标记智能组结果。
• dt tags：高级标记规范化、合并和重复数据删除。

批处理和队列

• dt queue add：将任务添加到持久队列。
• dt queue status：查看待处理和已完成的任务。
• dt queue execute：运行捆绑的优化操作。

______________________________________________________________________

🏗 建筑

dt 用Node.js编排层封装专门的JXA（JavaScript for Automation）脚本。

• src/queue.js：操作Look Ahead Bundler进行高速批处理。
• src/state.js：跟踪会话上下文（最近的记录/组）。
• jxa/：用于读写数据的直接AppleScript桥。

______________________________________________________________________

📄 许可证

麻省理工学院

由...创建 沈（2b3pro） 2B3制作有限责任公司

给我买杯咖啡☕️!