Todo List MCP

🚀 待办事项 MCP サーバー

このサーバーは、Model Context Protocol (MCP) を用いて、待办事項を管理するための包括的な API を提供します。

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

✨ 主な機能

• 待办事項の作成: タイトルと Markdown 形式の説明を含む新しいタスクを追加します。
• 待办事項の更新: 既存のタスクを修正します。
• 待办事項の完了: タスクを完了済みとしてマークします。
• 待办事項の削除: リストからタスクを削除します。
• 待办事項の検索: タイトルまたは作成日でタスクを検索します。
• 待办事項の要約: すべてのアクティブなタスクの概要を取得します。

📦 インストール

# リポジトリをクローンする
git clone https://github.com/RegiByte/todo-list-mcp.git
cd todo-list-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
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 設定」 -> 「MCP」に移動します。
• 新しい MCP サーバーを追加し、タイプを「コマンドライン」に設定します。
• サーバーの絶対パスを追加し、Node で実行します。
• 例: node /absolute/path/to/todo-list-mcp/dist/index.js

高度な使用法

Claude for Desktop または Cursor と組み合わせて使用する場合、以下のコマンドを試すことができます。

• 「MCP を学習するための待办事項を作成し、MCP が有用な理由を説明する記述を追加する」
• 「すべてのアクティブな待办事項をリストする」
• 「明日の会議のための待办事項を作成し、Markdown 形式で議題の詳細を含める」
• 「MCP を学習する待办事項を完了済みとしてマークする」
• 「すべてのアクティブな待办事項を要約する」

📚 ドキュメント

プロジェクト構造

プロジェクトのコードディレクトリは以下の通りです。

• models: データモデルとデータベースの相互作用ロジックを含みます。
• services: 核心的なビジネス機能の実装を提供します。
• routes: API ルートとエンドポイントを定義します。
• utils: 補助関数やその他のツールモジュールを含みます。

学習リソース

このプロジェクトは教育目的で設計されており、MCP 実装を学習するための基本的な構造を提供します。コードを読み、機能を実験し、その仕組みを探索することで、開発者は MCP の核心概念と技術を深く理解することができます。

開発

ビルド

npm run build

実行

npm start

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。