TodoリストMCPサーバー

ToDo 項目を管理するための包括的な API を提供するモデル コンテキスト プロトコル (MCP) サーバー。

📚 学習リソース：このプロジェクトは、MCP実装の教育的な例として設計されています。プロジェクトの仕組みと実装方法の詳細な説明については、 GUIDE.mdをご覧ください。

特徴

• ToDoを作成: タイトルとマークダウンの説明を付けて新しいタスクを追加します

• ToDo の更新: 既存のタスクを変更する

• タスクを完了する: タスクを完了としてマークする

• ToDo を削除: リストからタスクを削除します

• ToDo を検索: タイトルまたは作成日でタスクを検索

• タスクの概要: アクティブなタスクの概要を素早く把握

Related MCP server: Todo MCP Server

ツール

この MCP サーバーは次のツールを公開します。

1. create-todo : 新しい Todo アイテムを作成します

2. list-todos : すべてのToDoを一覧表示する

3. get-todo : IDで特定のToDoを取得する

4. update-todo : ToDo のタイトルまたは説明を更新する

5. complete-todo : Todo を完了としてマークします

6. delete-todo : ToDo を削除する

7. search-todos-by-title : タイトルでtodoを検索（大文字と小文字を区別しない部分一致）

8. search-todos-by-date : 作成日でToDoを検索します（形式: YYYY-MM-DD）

9. list-active-todos : 完了していないすべてのToDoを一覧表示する

10. summarize-active-todos : すべてのアクティブな（完了していない）todoの要約を生成する

インストール

# Clone the repository
git clone https://github.com/RegiByte/todo-list-mcp.git
cd todo-list-mcp

# Install dependencies
npm install

# Build the project
npm run build

使用法

サーバーの起動

npm start

Claude for Desktop での設定

クロードデスクトップ

これをclaude_desktop_config.jsonに追加します:

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/absolute/path/to/todo-list-mcp/dist/index.js"]
    }
  }
}

カーソル

• 「カーソル設定」-> MCPに移動します

• 「コマンド」タイプの新しいMCPサーバーを追加する

• サーバーの絶対パスを追加し、ノードで実行します

• 例: node /absolute/path/to/todo-list-mcp/dist/index.js

コマンド例

Claude for Desktop または Cursor と併用する場合は、次の操作を試してください。

• 「MCP がなぜ役立つのかを説明する説明を添えて、MCP を学ぶための ToDo を作成します」

• 「アクティブなToDoをすべて一覧表示する」

• 「明日の会議の議題の詳細をマークダウンでToDoに記入する」

• 「学習中のMCP ToDoを完了としてマークする」

• 「すべてのアクティブなToDoを要約する」

プロジェクト構造

このプロジェクトでは、コードを理解しやすくするために、明確な関心の分離を採用しています。

src/
├── models/       # Data structures and validation schemas
├── services/     # Business logic and database operations
├── utils/        # Helper functions and formatters
├── config.ts     # Configuration settings
├── client.ts     # Test client for local testing
└── index.ts      # Main entry point with MCP tool definitions

このプロジェクトから学ぶこと

このプロジェクトは教育リソースとして設計されています。最大限に活用するには、以下の点にご注意ください。

1. デザインの包括的な説明については、 GUIDE.mdをご覧ください。

2. 実装の詳細を理解するために、コメントが豊富なソースコードを調べます。

3. テストクライアントを使用して、サーバーが実際にどのように動作するかを確認します。

4. 独自のツールを追加したり、既存のツールを拡張したりして実験してみましょう

発達

建物

npm run build

開発モードで実行

npm run dev

ライセンス

マサチューセッツ工科大学