Tinderbox MCP

🚀 Tinderbox MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を用いて、ClaudeのようなAIアシスタントがmacOS用の強力な知識管理アプリケーションであるTinderboxとやり取りできるようにします。これにより、自然言語でTinderboxを操作し、アシスタントがアクセス可能な他のサービスと接続することができます。

🚀 クイックスタート

Tinderbox MCPサーバーを使用することで、AIアシスタントがTinderboxとやり取りできるようになります。以下の手順に従ってセットアップしてください。

✨ 主な機能

このサーバーには、以下のTinderbox操作が含まれています。

• create_note - ドキュメント内に新しいノートを作成します。
• link_notes - 既存のノート間にリンクを作成し、必要に応じてリンクタイプを指定できます。
• update_attributes - 指定したノートの属性値を変更します。
• read_note - ノートの内容を取得します（現在はノートのタイトルと本文のみ返します）。
• get_siblings - 同じ階層レベルのノートを見つけます（このツールや他のツールは、ノートのパスとChildCountを返し、アシスタントがさらに探索できる場所を把握できるようにします）。
• get_children - 指定した親ノートのすべての子ノートを取得します。
• get_links - 特定のノートのすべての出站リンクを検索します。

これらの操作はすべて、使用するドキュメントをモデルが知っている必要があります。デフォルトのドキュメント名はPlaygroundで、これは開発者のテスト用ドキュメントです。他のデフォルト値は、/src/index.tsのスクリプト構成で確認できます。

📦 インストール

前提条件

• Tinderbox
• Node.js 18以上
• MCP互換のクライアント（ここではClaude Desktopでのみテスト済み）

インストール手順

1. このリポジトリをクローンします。

git clone https://github.com/phkus/tinderbox-mcp.git
cd tinderbox-mcp

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

💻 使用例

サーバーの起動

以下のコマンドを使用してサーバーを起動します。

npm run start

Claude Desktopとの連携

1. Claude Desktopの設定ファイルに以下の設定を追加します。

{
  "Tinderbox MCP Server": {
    "path": "/path/to/tinderbox-mcp-server"
  }
}

2. サーバーを起動した後、Claude DesktopでTinderbox MCPサーバーをターゲットとして選択できます。

📚 ドキュメント

注意事項

⚠️ 重要提示

update_attributeツールは、既存のデータを上書きまたは削除する可能性があります。ドキュメントを定期的にバックアップすることを確認してください。

拡張提案

💡 使用建议

• Tinderbox MCPサーバーを他の知識管理システムと統合する
• DEVONthinkとBookendsのサポートを追加する
• 検索やフィルタリングなど、より複雑なクエリ機能を実装する

謝辞

Josh Rutkowskiの啓発的な仕事に感謝します。このプロジェクトの主な違いは、applescript - mcpが完全なスクリプト内容をターミナルに渡すのに対し、この実装は個別のスクリプトファイルを呼び出すことです。

Tinderboxの開発者であるMark Bernsteinにも感謝します。彼がこのスクリプト可能なアプリケーションを開発してくれたことに感謝します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

貢献

このプロジェクトへの貢献や、Tinderboxフォーラムでのフィードバック（ユーザー名：pkus）を歓迎します。