Todo List MCP Server

Todo List MCP サーバー

Todo アイテムを管理するための包括的な API を提供する Model Context Protocol（MCP）サーバーです。

📚 学習リソース：このプロジェクトは、MCP 実装の教育用サンプルとして設計されています。プロジェクトの仕組みや、各機能がそのように実装されている理由について詳しくは、GUIDE.mdをご覧ください。

機能

• Todo の作成：タイトルと Markdown の説明を指定して新しいタスクを追加します
• Todo の更新：既存のタスクを変更します
• 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

claude_desktop_config.jsonに次の内容を追加します。

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

Cursor

• 「Cursor Settings」-> MCP に移動します
• 「command」タイプで新しい MCP サーバーを追加します
• サーバーの絶対パスを追加し、node で実行します
• 例：node /absolute/path/to/todo-list-mcp/dist/index.js

コマンドの例

Claude for Desktop または Cursor で使用する場合は、次のように試せます。

• 「MCP が役立つ理由を説明する内容で、MCP を学ぶための Todo を作成して」
• 「進行中の Todo をすべて一覧表示して」
• 「明日の会議用の Todo を作成して。議題の詳細は Markdown で記載して」
• 「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

ライセンス

MIT