README.md•5.8 kB
# MCP Chain of Thought
[](https://youtu.be/hzOCwwGSQhs)
[](https://smithery.ai/server/@liorfranko/mcp-chain-of-thought)
> 🚀 An intelligent task management system based on Model Context Protocol (MCP), providing an efficient programming workflow framework for AI Agents.
<a href="https://glama.ai/mcp/servers/@liorfranko/mcp-chain-of-thought">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@liorfranko/mcp-chain-of-thought/badge" />
</a>
## 📑 Table of Contents
- [✨ Features](#features)
- [🧭 Usage Guide](#usage-guide)
- [🔧 Installation](#installation)
- [🔌 Using with MCP-Compatible Clients](#clients)
- [🛠️ Tools Overview](#tools)
- [🤖 Recommended Models](#recommended)
- [📄 License](#license)
- [📚 Documentation](#documentation)
## ✨ 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](#installation) 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
```bash
npx -y @smithery/cli install @liorfranko/mcp-chain-of-thought --client claude
```
### 🔽 Manual Installation
```bash
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`):
```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 |
## 🤖 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](LICENSE) file for details.
## 📚 Documentation
- [🏗️ System Architecture](docs/en/architecture.md)
- [🔧 Prompt Customization Guide](docs/en/prompt-customization.md)
- [📝 Changelog](CHANGELOG.md)
## ⭐ Star History
[](https://www.star-history.com/#liorfranko/mcp-chain-of-thought&Timeline)