Skip to main content
Glama

MCP Chain of Thought

Chain of Thought Demo

🚀 An intelligent task management system based on Model Context Protocol (MCP), providing an efficient programming workflow framework for AI Agents.

📑 Table of Contents

Related MCP server: MCP Shrimp Task Manager

✨ Features

  • 🧠 Task Planning & Analysis: Deep understanding of complex task requirements

  • 🧩 Intelligent Task Decomposition: Break down large tasks into manageable smaller tasks

  • 🔄 Dependency Management & Status Tracking: Handle dependencies and monitor progress

  • ✅ Task Verification: Ensure results meet requirements

  • 💾 Task Memory: Store task history for reference and learning

  • ⛓️ Thought Chain Process: Step-by-step reasoning for complex problems

  • 📋 Project Rules: Define standards to maintain consistency

  • 🌐 Web GUI: Optional web interface (enable with ENABLE_GUI=true)

  • 📝 Detailed Mode: View conversation history (enable with ENABLE_DETAILED_MODE=true)

🧭 Usage Guide

🚀 Quick Start

  1. 🔽 Installation: Install MCP Chain of Thought via Smithery or manually

  2. 🏁 Initial Setup: Tell the Agent "init project rules" to establish project-specific guidelines

  3. 📝 Plan Tasks: Use "plan task [description]" to create a development plan

  4. 👀 Review & Feedback: Provide feedback during the planning process

  5. ▶️ Execute Tasks: Use "execute task [name/ID]" to implement a specific task

  6. 🔄 Continuous Mode: Say "continuous mode" to process all tasks sequentially

🔍 Memory & Thinking Features

  • 💾 Task Memory: Automatically saves execution history for reference

  • 🔄 Thought Chain: Enables systematic reasoning through process_thought tool

  • 📋 Project Rules: Maintains consistency across your codebase

🔧 Installation

🔽 Via Smithery

npx -y @smithery/cli install @liorfranko/mcp-chain-of-thought --client claude

🔽 Manual Installation

npm install
npm run build

🔌 Using with MCP-Compatible Clients

⚙️ Configuration in Cursor IDE

Add to your Cursor configuration file (~/.cursor/mcp.json or project-specific .cursor/mcp.json):

{
  "mcpServers": {
    "chain-of-thought": {
      "command": "npx",
      "args": ["-y", "mcp-chain-of-thought"],
      "env": {
        "DATA_DIR": "/path/to/project/data", // Must use absolute path
        "ENABLE_THOUGHT_CHAIN": "true",
        "TEMPLATES_USE": "en",
        "ENABLE_GUI": "true",
        "ENABLE_DETAILED_MODE": "true"
      }
    }
  }
}

⚠️ Important: DATA_DIR must use an absolute path.

🔧 Environment Variables

  • 📁 DATA_DIR: Directory for storing task data (absolute path required)

  • 🧠 ENABLE_THOUGHT_CHAIN: Controls detailed thinking process (default: true)

  • 🌐 TEMPLATES_USE: Template language (default: en)

  • 🖥️ ENABLE_GUI: Enables web interface (default: false)

  • 📝 ENABLE_DETAILED_MODE: Shows conversation history (default: false)

🛠️ Tools Overview

Category

Tool

Description

📋 Planning

plan_task

Start planning tasks

analyze_task

Analyze requirements

process_thought

Step-by-step reasoning

reflect_task

Improve solution concepts

init_project_rules

Set project standards

🧩 Management

split_tasks

Break into subtasks

list_tasks

Show all tasks

query_task

Search tasks

get_task_detail

Show task details

delete_task

Remove tasks

▶️ Execution

execute_task

Run specific tasks

verify_task

Verify completion

complete_task

Mark as completed

  • 👑 Claude 3.7: Offers strong understanding and generation capabilities

  • 💎 Gemini 2.5: Google's latest model, performs excellently

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📚 Documentation

⭐ Star History

Star History Chart

Available Tools

15 tools
analyze_taskC

Deeply analyze task requirements and systematically check the codebase, evaluate technical feasibility and potential risks. If code is needed, use pseudocode format providing only high-level logic flow and key steps, avoiding complete code.

Inputs: initialConcept (required), summary (required), previousAnalysis.

clear_all_tasksB

Clear unfinished tasks and reset the task list

Inputs: confirm (required).

complete_taskC

Formally mark a task as completed, generate a detailed completion report, and update the dependency status of related tasks

Inputs: taskId (required), summary.

delete_taskA

Delete unfinished tasks, but does not allow deleting completed tasks, ensuring the integrity of system records

Inputs: taskId (required).

execute_taskC

Execute a specific task according to the predefined plan, ensuring the output of each step meets quality standards

Inputs: taskId (required).

get_task_detailC

Get the complete detailed information of a task based on its ID, including unabridged implementation guides and verification criteria, etc.

Inputs: taskId (required).

init_project_rulesB

Initialize project rules. Call this tool when the user requests to generate or initialize the project specification file, or if the user requests to change or update the project specification.

Inputs: no named parameters.

list_tasksC

Generate a structured task list, including complete status tracking, priority, and dependencies

Inputs: status (required).

plan_taskB

Initialize and detail the task flow, establish clear goals and success criteria, optionally reference existing tasks for continuation planning

Inputs: description (required), existingTasksReference, requirements.

process_thoughtB

Engage in a flexible and evolving thinking process by creating, questioning, validating, and refining ideas to progressively deepen understanding and generate effective solutions. When needing to gather data, analyze, or research, prioritize reviewing relevant project code; if such code doesn't exist, search the web rather than speculating. Set nextThoughtNeeded to false when thinking is sufficient, otherwise adjust total_thoughts to extend the process

Inputs: next_thought_needed (required), stage (required), thought (required), thought_number (required), +4 more.

query_taskC

Search tasks by keyword or ID, displaying abbreviated task information

Inputs: query (required), isId, page, pageSize.

reflect_taskB

Critically review analysis results, evaluate solution completeness and identify optimization opportunities, ensuring the solution aligns with best practices. If code is needed, use pseudocode format providing only high-level logic flow and key steps, avoiding complete code.

Inputs: analysis (required), summary (required).

split_tasksA

Decompose complex tasks into independent subtasks, establishing dependencies and priorities.

updateMode

  • append: Keep existing tasks and add new ones

  • overwrite: Delete unfinished tasks, keep completed ones

  • selective: Intelligently match and update existing tasks based on name

  • clearAllTasks: Clear all tasks and create a backup (preferred mode)

Key Requirements

  • Provide concise pseudocode: Only provide high-level logic flow and key steps, avoid complete code

  • Consolidate when necessary: Simple modifications can be integrated with other tasks to avoid excessive task count

  • Submit in batches: If there are too many tasks, use the "split_tasks" tool with parameters not exceeding 5000 characters

Inputs: tasks (required), updateMode (required), globalAnalysisResult.

update_taskB

Update task content, including name, description and notes, dependent tasks, related files, implementation guide and verification criteria. Completed tasks only allow updating summary and related files

Inputs: taskId (required), dependencies, description, implementationGuide, +4 more.

verify_taskC

Comprehensively verify task completion, ensuring all requirements and technical standards are met without missing details

Inputs: taskId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 15 tools

    Disambiguation3/5

    The tools have overlapping purposes that could cause confusion, such as 'analyze_task' and 'reflect_task' both involving analysis and pseudocode, and 'list_tasks' and 'query_task' both retrieving task information. However, descriptions help differentiate some tools, like 'execute_task' for action versus 'plan_task' for planning, reducing ambiguity.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (e.g., 'analyze_task', 'list_tasks', 'update_task'), with only minor deviations like 'init_project_rules' using 'init' instead of a more standard verb. The naming is readable and predictable overall, though not perfectly uniform.

    Tool Count5/5

    With 15 tools, the count is well-scoped for a task management and analysis system. Each tool appears to serve a distinct function in the workflow, from initialization to execution and verification, making the set comprehensive without being excessive.

    Completeness5/5

    The tool set provides complete coverage for task lifecycle management, including initialization ('init_project_rules'), planning ('plan_task'), execution ('execute_task'), monitoring ('list_tasks', 'query_task'), and completion ('complete_task', 'verify_task'). No obvious gaps exist, as it supports CRUD operations and advanced features like reflection and splitting.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought, reflection, and style consistency. It converts natural language into structured dev tasks with dependency tracking and iterative refinement, enabling agent-like developer behavior in reasoning AI systems.
      15
      405 npm
      2,150
      TypeScript
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An intelligent task management system that provides structured workflows for AI Agents to plan, decompose, and execute complex programming tasks. It features a dedicated research mode for technical investigations and a task memory function to optimize workflows and avoid redundant coding work.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides AI agents with a lightweight task-management and self-verification layer to define goals, track checkpoints, detect scope drift, and verify completion against explicit done criteria.
      12
      MIT