mcp-chain-of-thought
The MCP Chain of Thought server is an intelligent task management system for AI-driven project planning and execution. Key capabilities include:
Task Planning & Analysis: Analyze requirements, evaluate feasibility, and define success criteria
Step-by-Step Reasoning: Systematic problem-solving with
process_thoughtTask Decomposition: Break down complex tasks into manageable subtasks
Dependency Management: Handle task relationships, priorities, and track progress
Task Execution & Verification: Execute tasks and verify completion against criteria
Project Rules Management: Initialize and update project-specific guidelines
Task Operations: Search, update, delete, or query tasks by keyword or ID
Reporting: Generate completion reports and maintain task history
Interface Options: Optional web GUI and detailed conversation history mode
Enables installation of the MCP Chain of Thought server via npm packages, with support for project-specific configuration.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-chain-of-thought plan task for adding user authentication to our web app"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Chain of Thought
🚀 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
🔽 Installation: Install MCP Chain of Thought via Smithery or manually
🏁 Initial Setup: Tell the Agent "init project rules" to establish project-specific guidelines
📝 Plan Tasks: Use "plan task [description]" to create a development plan
👀 Review & Feedback: Provide feedback during the planning process
▶️ Execute Tasks: Use "execute task [name/ID]" to implement a specific task
🔄 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_thoughttool📋 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_DIRmust 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 |
| Start planning tasks |
| Analyze requirements | |
| Step-by-step reasoning | |
| Improve solution concepts | |
| Set project standards | |
🧩 Management |
| Break into subtasks |
| Show all tasks | |
| Search tasks | |
| Show task details | |
| Remove tasks | |
▶️ Execution |
| Run specific tasks |
| Verify completion | |
| Mark as completed |
🤖 Recommended Models
👑 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
Available Tools
15 toolsanalyze_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
Scored across 15 tools
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.
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.
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.
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
Related MCP Connectors
Task management for teams building with AI agents. Agents claim tasks and report progress.
Task manager for AI agents. Orchestrate agents to achieve large goals in unified control plane.
AI-powered spec-to-task decomposition and execution orchestration for coding agents.
AI-native task management: list, create, update and archive tasks with rich context for AI agents
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP 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.15405 npm2,150TypeScriptMIT
- AlicenseNot gradedqualityDmaintenanceAn 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.1MIT
- FlicenseNot gradedqualityDmaintenanceLightweight project management for teams and AI agents.-
- AlicenseAqualityDmaintenanceProvides 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.12MIT