Claude Todo Emulator

🚀 Claude Todo MCP Server

このプロジェクトは、CursorやWindsurfなどのIDEにおけるAIコーディングアシスタントに永続的なタスク管理機能を追加します。Claude Codeのtodoシステムを再現し、AIアシスタントに複雑なタスクの追跡や管理能力を付与します。

🚀 クイックスタート

インストール不要！ あなたのMCP設定に以下の内容を追加するだけです。

{
  "mcpServers": {
    "task-manager": {
      "command": "uvx",
      "args": ["claude-todo-emulator"]
    }
  }
}

• Cursor：プロジェクトのルートに .cursor/mcp.json を作成します。
• その他のIDE：MCP設定ファイルに追加します。

IDEを再起動 して、 "Create a todo list for adding user authentication" を試してみてください。

初回使用時にシステムが自動的にパッケージをダウンロードし、すべてをセットアップします！

✨ 主な機能

タスク管理の必要性

タスク管理がない場合、AIアシスタントは以下の問題に直面します。

• ❌ 会話の途中で作業中の内容を忘れる
• ❌ 多段階の実装を追跡できない
• ❌ 複雑な作業の優先順位付けや整理ができない
• ❌ コンテキストを切り替えるとタスクが中途半端になる

このMCPサーバを使用することで、以下のメリットがあります。

• ✅ 永続的なメモリ - セッションをまたいでタスクが保存される
• ✅ プロジェクトスコープ - 各ワークスペースに独自のtodoリストがある
• ✅ 自動追跡 - AIがタスクの作成/更新タイミングを知る
• ✅ 進捗可視化 - 完了/未実行のタスクを正確に把握できる
• ✅ 集中力の維持 - 一度に進行中のタスクは1つのみ

設定後の機能

設定後、AIアシスタントは自動的に以下のことを行います。

複雑なタスクのtodo作成

You: "Add dark mode support with user preferences"
AI: "I'll create a todo list for this multi-step feature:
- ✅ Add theme context and state management
- 🔄 Create dark mode CSS variables and styles
- ⏳ Build settings UI for theme switching
- ⏳ Add persistence to localStorage
- ⏳ Update existing components for theme support"

進捗の視覚的追跡

You: "What's the status on the authentication system?"
AI: "Current authentication tasks:
- ✅ Set up JWT middleware
- ✅ Create login/signup endpoints
- 🔄 Building user profile management (in progress)
- ⏳ Add password reset flow
- ⏳ Implement role-based permissions"

集中力の維持

You: "Let's also add email notifications"
AI: "I'll add that to the todo list, but let me finish the current user profile task first to maintain focus."

📚 ドキュメント

📄 APIリファレンス

TodoRead

• パラメータ：なし
• 戻り値：{todos: Todo[]}

TodoWrite

• パラメータ：{todos: Todo[]}
• 戻り値：{success: boolean, count: number}

Todoスキーマ

{
  id: string;
  content: string;
  status: "pending" | "in_progress" | "completed";
  priority: "high" | "medium" | "low";
  created_at: string;
  updated_at: string;
  metadata?: object;
}

🤝 コントリビュート方法

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 新機能のテストを追加する
4. プルリクエストを送信する

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

関連プロジェクト

• Model Context Protocol
• FastMCP
• Claude Code