DEVONthink

Devonthink MCP サーバー

この MCP サーバーは、Model Context Protocol (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、任意の 2 番目のレコード UUID、データベース名、および比較タイプ
    • 戻り値: 類似レコード (シングルモード) または詳細な比較分析 (2 レコードモード) のいずれか

例: 検索ツール

{
  "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 を使用した包括的なテストを含みます

完全なドキュメント、ツール開発ガイドライン、および API リファレンスについては CLAUDE.md を参照してください。