Todo List MCP Server

by RegiByte
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

TodoリストMCPサーバー

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

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

特徴

  • ToDoを作成: タイトルとマークダウンの説明を付けて新しいタスクを追加します
  • ToDo の更新: 既存のタスクを変更する
  • タスクを完了する: タスクを完了としてマークする
  • ToDo を削除: リストからタスクを削除します
  • ToDo を検索: タイトルまたは作成日でタスクを検索
  • タスクの概要: アクティブなタスクの概要を素早く把握

ツール

この 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

ライセンス

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

タスクの作成、更新、完了、削除、検索、要約などの ToDo 項目を管理するためのツールを提供するモデル コンテキスト プロトコル (MCP) サーバー。

  1. Features
    1. Tools
      1. Installation
        1. Usage
          1. Starting the Server
          2. Configuring with Claude for Desktop
          3. Example Commands
        2. Project Structure
          1. Learning from This Project
            1. Development
              1. Building
              2. Running in Development Mode
            2. License
              ID: kh39rjpplx