MCP Todo.txt Integration

---

MCP Todo.txt 統合

概要

MCP Todo.txt 統合は、Todo.txt ファイルとのやり取りを可能にする Model Context Protocol（MCP）のサーバー実装です。このプロジェクトでは、LLM が MCP プロトコルを使用して、Todo.txt ファイル内のタスクをプログラムで管理できます。

機能

主な機能

• リソース

  • タスクの一覧をリソースとして公開します。
  • コンテキスト、プロジェクト、優先度でタスクを絞り込みます。

• ツール

  1. タスクの追加：任意のメタデータとともに新しいタスクを追加します。
  2. タスクを完了としてマーク：タスクを完了としてマークします。
  3. タスクの削除：タスクを削除します。
  4. タスクの一覧表示：フィルタリングオプションを指定してすべてのタスクを取得します。
  5. タスクの検索：キーワードまたはメタデータに基づいてタスクを検索します。
  6. タスクの並べ替え：優先度、作成日、または完了日でタスクを並べ替えます。
  7. タスクの絞り込み：特定の条件でタスクを絞り込みます。
  8. メタデータの追加：タスクにカスタムメタデータを追加します。
  9. メタデータの削除：タスクから特定のメタデータを削除します。
  10. 一括操作：一括更新または削除を実行します。

• プロンプト

  • タスクを要約します。
  • 新しいタスクの説明を生成します。

高度な機能

• 動的なタスク管理：入力またはトリガーに基づいてタスクを動的に更新します。
• セッション管理：複数のリクエストにわたってタスクを管理します。

インストール

すばやくインストールするには、以下のワンクリックインストールボタンを使用してください。

1. リポジトリをクローンします：

   git clone <repository-url>
   cd todomcp
   

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

   npm install
   

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

   npm run build
   

使用方法

1. MCP サーバーを起動します：

   npm start
   

2. MCP に準拠したクライアントまたはツールを使用して、サーバーとやり取りします。

設定

• Todo.txt ファイルのパスは、TODO_FILE_PATH 環境変数を使用して設定できます。設定されていない場合、デフォルトのパスはプロジェクトのルートにある todo.txt です。

開発

• プロジェクトを開発モードで実行するには：

  npm run dev
  

• テストを実行するには：

  npm test
  

依存関係

• @modelcontextprotocol/sdk
• jsTodoTxt
• zod

ドキュメント

• Todo.txt の形式
• jsTodoTxt のドキュメント

コントリビューション

コントリビューションを歓迎します！改善やバグ修正については、課題を作成するか、プルリクエストを送信してください。

ライセンス

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