SimpleCheckList
Advanced SimpleCheckList with MCP server and SQLite database
Ask AI about SimpleCheckList
Powered by Claude Β· Grounded in docs
I know everything about SimpleCheckList. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
![]()
SimpleCheckList MCP Server
Advanced task and project management MCP server with hierarchical organization, AI-powered planning, and comprehensive analytics
π Quick Start
π Full-Stack Web Application (FIXED in v1.0.2):
# Complete project management application with web UI + API
docker run -d -p 8080:80 -p 8355:8355 mayurkakade/mcp-server:latest
# Access:
# - Web UI: http://localhost:8080 (Complete project management interface)
# - API: http://localhost:8355/api (MCP server endpoints)
# - Health: http://localhost:8355/api/health
Note: Use
mayurkakade/mcp-server:v1.0.2for the specific fixed version with frontend startup issues resolved.
π‘ API-Only Mode (Original):
# Backend API server only (for MCP integration)
docker run -p 8355:8355 mayurkakade/mcp-server:latest backend
# Access the API at http://localhost:8355/api/health
# MCP server ready for Claude Desktop integration!
For Developers:
# Clone the repository for development
git clone https://github.com/DevMayur/SimpleCheckList.git
cd SimpleCheckList
# Quick setup (installs dependencies and initializes database)
./setup.sh
# Start the full stack
npm run dev
π Overview
SimpleCheckList is a comprehensive Model Context Protocol (MCP) server that provides AI applications with powerful project management capabilities. It features a hierarchical organization system, AI-powered planning assistance, and real-time analytics.
π§ Recent Updates (v1.0.2)
β Docker Frontend Issues FIXED: The latest version resolves all Docker container startup problems:
- Frontend Startup Fixed: React app now serves properly on port 80
- Backend API Fixed: Server starts correctly and responds on port 8355
- Nginx Configuration: Resolved redirect loops and file serving issues
- Both Services Working: Complete full-stack deployment now functional
Migration: If you had issues with v1.0.1, simply pull the latest image:
docker pull mayurkakade/mcp-server:latest
π― Key Features
- π Full-Stack Web UI: Complete React-based project management interface (FIXED in v1.0.2)
- β Docker Frontend Fixed: Resolved startup issues, both frontend and backend work seamlessly
- π§ Hierarchical Organization: Projects β Groups β Task Lists β Tasks β Subtasks
- π οΈ 20 Comprehensive Tools: Complete CRUD operations for all entity types
- π 5 Resource Endpoints: Real-time data access and analytics
- π€ 4 AI-Powered Prompts: Intelligent planning and analysis assistance
- π Enterprise Security: Comprehensive security audit passed
- π Multi-Deployment: Web UI, API-only, local, Docker, and cloud options
ποΈ Architecture
Project
βββ Groups (Frontend, Backend, Testing, etc.)
β βββ Task Lists (User Auth, API Endpoints, etc.)
β β βββ Tasks (Individual work items)
β β β βββ Subtasks (Granular breakdown)
π§ Installation
Prerequisites
- Node.js 18+ (for local installation)
- Docker (for containerized deployment)
- SQLite3 (for local installation)
Method 1: Docker Hub (Recommended) π³
Full-Stack Web Application (v1.0.2 - RECOMMENDED):
# Complete application with web UI + API - FIXED VERSION
docker run -d --name simplechecklist-fullstack \
-p 8080:80 \
-p 8355:8355 \
-v simplechecklist_data:/app/data \
--restart unless-stopped \
mayurkakade/mcp-server:latest
# Access:
# - Web UI: http://localhost:8080
# - API: http://localhost:8355/api
# For specific version:
# mayurkakade/mcp-server:v1.0.2 (recommended - has frontend fixes)
API-Only Mode:
# Backend API server only (for MCP integration)
docker run -d --name simplechecklist-api \
-p 8355:8355 \
-v simplechecklist_data:/app/data \
--restart unless-stopped \
mayurkakade/mcp-server:latest backend
Docker Compose (Production):
# Use the full-stack compose file
docker-compose -f docker-compose.fullstack.yml up -d
# Access:
# - Web UI: http://localhost:8080
# - API: http://localhost:8355/api
Method 2: Quick Setup Script
./setup.sh
Method 3: Manual Installation
# Install dependencies
npm install
cd server && npm install
cd ../client && npm install
cd ../mcp-server && npm install
# Initialize database
cd server && npm run init-db
# Start services
cd .. && npm run dev
Method 4: Docker Compose
docker-compose up --build
π€ MCP Integration
Cursor IDE Configuration
New! Complete setup guide for Cursor IDE users:
π Cursor MCP Setup Guide - Step-by-step instructions
Quick Setup:
- Go to Cursor Settings β MCP β New MCP Server
- Name:
simple-checklist - Command:
node - Args:
/path/to/SimpleCheckList/mcp-server/index.js - Env:
API_BASE_URL=http://localhost:8355/api
Claude Desktop Configuration
Option 1: Docker (Recommended)
{
"mcpServers": {
"simple-checklist": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "API_BASE_URL=http://host.docker.internal:8355/api",
"--add-host=host.docker.internal:host-gateway",
"mayurkakade/mcp-server:latest",
"sh", "-c", "cd /app/mcp-server && node index.js"
]
}
}
}
Option 2: Local Installation
{
"mcpServers": {
"simple-checklist": {
"command": "node",
"args": ["/path/to/SimpleCheckList/mcp-server/index.js"],
"env": {
"API_BASE_URL": "http://localhost:8355/api"
}
}
}
}
Available Tools (20)
Project Management
list_projects- Get all projects with metadatacreate_project- Create new projectget_project- Get specific project detailsupdate_project- Modify project propertiesdelete_project- Remove project and contents
Task Management
create_task- Create tasks with priority, due dates, metadatalist_tasks- Get tasks for specific task listupdate_task- Modify task propertiestoggle_task_completion- Mark tasks complete/incompletedelete_task- Remove tasks and subtasks
Analytics
get_project_stats- Comprehensive project statisticsget_all_tasks- System-wide task analysis
See full tool documentation β
Resource Endpoints (5)
checklist://projects- All projects with metadatachecklist://tasks/all- All tasks across projectschecklist://stats/summary- System-wide statisticschecklist://projects/{id}- Specific project detailschecklist://projects/{id}/hierarchy- Complete project structure
AI-Powered Prompts (4)
create_project_plan- Automated project structure generationanalyze_project_progress- Intelligent progress analysissuggest_task_breakdown- Smart task decompositiongenerate_status_report- Comprehensive reporting
π Web UI Features (v1.0.2+ - WORKING)
The full-stack deployment includes a complete React-based web interface with all startup issues fixed:
π Project Management Dashboard
- Visual Project Overview: See all projects with progress indicators
- Hierarchical Task Organization: Drill down from projects to subtasks
- Real-time Updates: Live progress tracking and completion status
- Responsive Design: Works on desktop, tablet, and mobile devices
π― Task Management Interface
- Drag & Drop: Intuitive task organization and prioritization
- Rich Task Details: Add descriptions, due dates, priorities, and metadata
- Progress Tracking: Visual completion indicators and statistics
- Search & Filter: Find tasks quickly across projects
π Analytics & Reporting
- Project Statistics: Completion rates, task distribution, progress charts
- Time Tracking: Due date management and deadline monitoring
- Export Capabilities: Generate reports and export data
π§ Admin Features
- User Management: Multi-user support with role-based access
- Settings Panel: Configure preferences and system settings
- Data Import/Export: Backup and restore project data
π Usage Examples
Web UI Usage
- Start the application:
docker run -d -p 8080:80 -p 8355:8355 mayurkakade/mcp-server:latest - Open your browser: Navigate to
http://localhost:8080 - Create your first project: Click "New Project" and follow the wizard
- Organize with groups: Add Frontend, Backend, Testing groups
- Add task lists: Create specific feature lists within groups
- Track progress: Mark tasks complete and watch progress indicators update
Note: v1.0.2 has all Docker frontend startup issues resolved - both UI and API work seamlessly!
API Usage - Creating a Web Application Project
// 1. Create project
create_project({
name: "E-commerce Platform",
description: "Full-stack e-commerce with React and Node.js",
color: "#2563EB"
})
// 2. Create groups
create_group({
project_id: "project-id",
name: "Frontend",
description: "React UI components"
})
// 3. Create tasks with rich metadata
create_task({
task_list_id: "task-list-id",
title: "Implement user authentication",
description: "Complete auth system with JWT",
priority: "high",
metadata: {
files: ["auth.service.ts", "login.component.tsx"],
acceptance_criteria: [
"JWT token generation",
"Protected routes",
"Password validation"
]
}
})
AI-Assisted Planning
// Get AI help for project planning
create_project_plan({
project_name: "Mobile App Development",
complexity: "complex"
})
// Analyze project progress
analyze_project_progress({
project_id: "project-id"
})
π Security
SimpleCheckList has undergone a comprehensive security audit:
- β No Critical Vulnerabilities
- β Input Validation & Sanitization
- β SQL Injection Protection
- β Secure Error Handling
- β Enterprise-Grade Controls
View Security Audit Report β
π API Reference
REST API Endpoints
- Projects:
/api/projects - Groups:
/api/projects/:id/groups - Task Lists:
/api/groups/:id/task-lists - Tasks:
/api/task-lists/:id/tasks - Subtasks:
/api/tasks/:id/subtasks
Complete API Documentation β
π Deployment
Local Development
npm run dev
# Backend: http://localhost:8355
# Frontend: http://localhost:8354
Docker Production
docker-compose up --build
Environment Variables
# Backend API URL for MCP server
API_BASE_URL=http://localhost:8355/api
# Database path (optional)
DATABASE_PATH=./data/checklist.db
π Documentation
- Cursor MCP Setup Guide - Complete Cursor IDE integration guide
- MCP Server Documentation - Complete MCP integration guide
- AI Agent Integration - AI application examples
- Security Audit - Comprehensive security analysis
- Registry Submission - Anthropic registry details
π― Anthropic MCP Registry
SimpleCheckList is ready for submission to the Anthropic MCP Registry:
- β MCP specification compliance
- β Security audit passed
- β Comprehensive documentation
- β Registry manifest prepared
- β Production deployment tested
View Registry Submission Guide β
π€ Contributing
We welcome contributions! Please see our Contributing Guidelines for details.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Support
- Documentation: Check our comprehensive guides above
- Issues: Create a GitHub issue
- Discussions: GitHub Discussions
π Acknowledgments
- Built with Model Context Protocol
- Designed for Claude Desktop integration
- Inspired by modern project management methodologies
