mayurkakade/mcp-server repository overview

⁠SimpleCheckList MCP Server - Docker Hub

A comprehensive Model Context Protocol (MCP) server with full-stack web UI, featuring hierarchical project organization and real-time updates.

⁠🚀 Quick Start

⁠Pull & Run

docker pull mayurkakade/mcp-server:latest

docker run -d --name simplechecklist \
  -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⁠

⁠🎯 Integration Options

⁠1️⃣ Use with Cursor

1. Run the container (see Quick Start above)

2. Add to Cursor MCP config (~/.cursor/mcp.json):

{
  "mcpServers": {
    "simple-checklist": {
      "command": "node",
      "args": ["/path/to/mcp-server/index.js"],
      "env": {
        "API_BASE_URL": "http://localhost:8355/api"
      }
    }
  }
}

1. Restart Cursor and start managing projects with AI assistance!

⁠2️⃣ Use with Claude Desktop

1. Run the container (see Quick Start above)

2. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "simple-checklist": {
      "command": "node",
      "args": ["/path/to/mcp-server/index.js"],
      "env": {
        "API_BASE_URL": "http://localhost:8355/api"
      }
    }
  }
}

1. Restart Claude Desktop and enjoy AI-powered project management!

⁠3️⃣ Use with n8n (SSL Required)

1. Run the container (see Quick Start above)

2. Install ngrok for SSL tunneling:

# Install ngrok
brew install ngrok  # macOS
# or download from https://ngrok.com/

# Create SSL tunnel
ngrok http 8355

1. Copy the HTTPS URL from ngrok (e.g., https://abc123.ngrok.io)

2. Configure n8n MCP node:

   • Base URL: https://abc123.ngrok.io/api
   • Headers: Content-Type: application/json

3. Use in n8n workflows with full HTTPS support!

⁠✨ Features

• 🔄 Real-time updates - WebSocket-powered collaboration
• 📋 Hierarchical organization - Projects → Groups → Task Lists → Tasks → Subtasks
• 🛠️ 20+ MCP tools - Complete CRUD operations
• 📊 5 resource endpoints - Real-time data access
• 🤖 4 AI prompts - Intelligent planning assistance
• 🌐 Full-stack web UI - Complete React-based interface
• 🐳 Docker ready - One-command deployment

⁠🔧 Environment Variables

# Optional customization
docker run -d --name simplechecklist \
  -p 8080:80 \
  -p 8355:8355 \
  -e NODE_ENV=production \
  -e DATABASE_PATH=/app/data/checklist.db \
  -v simplechecklist_data:/app/data \
  mayurkakade/mcp-server:latest

⁠📊 Health Check

curl http://localhost:8355/api/health
# Response: {"status":"OK","timestamp":"..."}

⁠🔗 Links

• 📚 Documentation: GitHub Repository⁠
• 🐛 Issues: GitHub Issues⁠
• 📦 Versions: Docker Hub Tags⁠

Version: v1.1.0+ | License: MIT | Maintainer: @DevMayur⁠