{"id":28599110,"url":"https://github.com/ejb503/systemprompt-mcp-taskchecker","last_synced_at":"2026-04-28T00:33:08.587Z","repository":{"id":298279446,"uuid":"999450151","full_name":"Ejb503/systemprompt-mcp-taskchecker","owner":"Ejb503","description":"Model Context Protocol (MCP) server for intelligent task management, evaluation scoring, and session-based workflow tracking. Seamlessly integrates with AI assistants to provide structured task orchestration, real-time progress monitoring, and comprehensive evaluation metrics. ","archived":false,"fork":false,"pushed_at":"2025-06-10T09:50:49.000Z","size":96,"stargazers_count":1,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-11T14:55:44.581Z","etag":null,"topics":["mcp","mcp-server","modelcontextprotocol","productivity","streamable-http"],"latest_commit_sha":null,"homepage":"https://systemprompt.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ejb503.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-10T09:11:30.000Z","updated_at":"2025-07-26T04:58:59.000Z","dependencies_parsed_at":"2025-06-10T09:45:43.437Z","dependency_job_id":"47c825e8-54f8-4e62-b832-468044a9e7ac","html_url":"https://github.com/Ejb503/systemprompt-mcp-taskchecker","commit_stats":null,"previous_names":["ejb503/systemprompt-mcp-taskchecker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Ejb503/systemprompt-mcp-taskchecker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ejb503%2Fsystemprompt-mcp-taskchecker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ejb503%2Fsystemprompt-mcp-taskchecker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ejb503%2Fsystemprompt-mcp-taskchecker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ejb503%2Fsystemprompt-mcp-taskchecker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ejb503","download_url":"https://codeload.github.com/Ejb503/systemprompt-mcp-taskchecker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ejb503%2Fsystemprompt-mcp-taskchecker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32361477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"ssl_error","status_checked_at":"2026-04-27T20:07:00.910Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","mcp-server","modelcontextprotocol","productivity","streamable-http"],"created_at":"2025-06-11T12:14:10.347Z","updated_at":"2026-04-28T00:33:08.577Z","avatar_url":"https://github.com/Ejb503.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 SystemPrompt MCP TaskChecker\n\n\u003e **Enterprise-grade Model Context Protocol server for intelligent task management, evaluation scoring, and session-based workflow tracking.**\n\n[![Built by SystemPrompt.io](https://img.shields.io/badge/Built%20by-SystemPrompt.io-blue?style=for-the-badge\u0026logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTEyIDJMMTMuMDkgOC4yNkwyMCA5TDEzLjA5IDE1Ljc0TDEyIDIyTDEwLjkxIDE1Ljc0TDQgOUwxMC45MSA4LjI2TDEyIDJaIiBmaWxsPSIjMDA3QUZGIi8+Cjwvc3ZnPgo=)](https://systemprompt.io)\n[![MIT License](https://img.shields.io/badge/License-MIT-red?style=for-the-badge)](LICENSE)\n\n**Seamlessly integrates with AI assistants to provide structured task orchestration, real-time progress monitoring, and comprehensive evaluation metrics for next-generation AI-driven productivity solutions.**\n\n---\n\n## ✨ What is SystemPrompt MCP TaskChecker?\n\nThe **SystemPrompt MCP TaskChecker** is a Model Context Protocol (MCP) server that transforms how AI assistants handle task management and workflow orchestration. Built by [SystemPrompt.io](https://systemprompt.io), this enterprise-grade solution bridges the gap between AI intelligence and structured productivity workflows.\n\n### 🎯 Key Value Propositions\n\n- **🤖 AI-Native Task Management**: Purpose-built for seamless integration with Claude, GPT, and other AI assistants\n- **📊 Intelligent Evaluation Scoring**: 0-100 scoring system with comprehensive metrics tracking\n- **⚡ Session-Based Architecture**: Stateful, secure, and automatically managed sessions\n- **🏢 Enterprise-Ready**: Production-grade reliability with comprehensive error handling\n- **🔄 Real-Time Workflow Tracking**: Live status updates and progress monitoring\n- **🛡️ Secure \u0026 Compliant**: Built-in validation, session management, and data integrity\n\n---\n\n## 🌟 Key Features\n\n### 🎯 **Intelligent Task Orchestration**\n- **Dynamic Task Lists**: Create and manage sophisticated task hierarchies with optional initialization\n- **Smart Status Tracking**: Real-time status updates (`pending` → `in_progress` → `completed`)\n- **Acceptance Criteria**: Define clear, measurable completion requirements for each task\n- **Flexible Updates**: Modify any task property while maintaining data integrity\n\n### 📈 **Advanced Evaluation System**\n- **Precision Scoring**: 0-100 evaluation scale for completed tasks\n- **Quality Metrics**: Track task completion quality and performance indicators\n- **Historical Analysis**: Maintain evaluation history for continuous improvement\n- **Success Benchmarking**: Compare and analyze task completion patterns\n\n### 🔒 **Enterprise Session Management**\n- **Stateful Operations**: Maintain context across multiple interactions\n- **Automatic Cleanup**: Intelligent session timeout and resource management\n- **Concurrent Support**: Handle multiple simultaneous sessions\n- **Security Validation**: Built-in session ID validation and error handling\n\n### 🚀 **Production-Grade Architecture**\n- **MCP 2025-03-26 Compliant**: Latest Model Context Protocol standards\n- **Streamable HTTP Transport**: High-performance, scalable communication\n- **Structured Error Handling**: Comprehensive error responses and logging\n- **TypeScript Native**: Full type safety and developer experience\n\n---\n\n## 🛠️ Installation \u0026 Setup\n\n### Prerequisites\n- **Node.js**: Version 18.0.0 or higher\n- **npm**: Latest stable version\n- **TypeScript**: Included in devDependencies\n\n### Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/Ejb503/systemprompt-mcp-taskchecker.git\ncd systemprompt-mcp-taskchecker\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Start the server\nnpm start\n```\n\n### Development Environment\n\n```bash\n# Development mode with hot reload\nnpm run dev\n\n# Run tests\nnpm test\n\n# Run with coverage\nnpm run test:coverage\n\n# Test client integration\nnpm run test:client\n```\n\n### Docker Deployment\n\n```bash\n# Build Docker image\nnpm run docker:build\n\n# Run in container\nnpm run docker:run\n```\n\n---\n\n## 🎮 Usage Examples\n\n### Basic Task List Creation\n\n```json\n{\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"create_tasklist\",\n    \"arguments\": {\n      \"initialTasks\": [\n        {\n          \"title\": \"Implement user authentication\",\n          \"acceptanceCriteria\": \"User can login with email/password and receive JWT token\"\n        },\n        {\n          \"title\": \"Create dashboard UI\",\n          \"acceptanceCriteria\": \"Responsive dashboard showing user metrics and navigation\"\n        }\n      ]\n    }\n  }\n}\n```\n\n### Task Status Updates\n\n```json\n{\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"update_task\",\n    \"arguments\": {\n      \"taskListId\": \"uuid-task-list-id\",\n      \"taskId\": \"uuid-task-id\",\n      \"updates\": {\n        \"status\": \"completed\",\n        \"evaluation\": 95\n      }\n    }\n  }\n}\n```\n\n### Comprehensive Status Retrieval\n\n```json\n{\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"get_status\",\n    \"arguments\": {\n      \"taskListId\": \"uuid-task-list-id\"\n    }\n  }\n}\n```\n\n---\n\n## 🔧 MCP Tools Reference\n\n### `create_tasklist`\n**Creates a new task list for the current session with optional initial tasks**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `initialTasks` | `Array\u003cTask\u003e` | No | Array of initial tasks to create |\n\n**Response Structure:**\n```typescript\n{\n  success: boolean;\n  data: {\n    id: string;\n    sessionId: string;\n    tasks: Task[];\n    createdAt: Date;\n    lastAccessed: Date;\n  }\n}\n```\n\n### `update_task`\n**Updates specific task properties including status, evaluation, and metadata**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `taskListId` | `string` | Yes | ID of the target task list |\n| `taskId` | `string` | Yes | ID of the task to update |\n| `updates` | `TaskUpdates` | Yes | Object containing properties to update |\n\n**Available Updates:**\n- `title`: Task title (string)\n- `status`: Task status (`pending` \\| `in_progress` \\| `completed`)\n- `acceptanceCriteria`: Completion criteria (string)\n- `evaluation`: Quality score (0-100)\n\n### `get_status`\n**Retrieves current status for all tasks or a specific task**\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `taskListId` | `string` | Yes | ID of the task list to query |\n| `taskId` | `string` | No | Optional specific task ID |\n\n---\n\n## 📊 Data Models\n\n### Task Structure\n```typescript\ninterface Task {\n  id: string;                    // Unique task identifier\n  title: string;                 // Task title/description\n  status: TaskStatus;            // Current task status\n  acceptanceCriteria: string;    // Completion requirements\n  evaluation?: number;           // Quality score (0-100)\n  createdAt: Date;              // Creation timestamp\n  updatedAt: Date;              // Last modification timestamp\n}\n\ntype TaskStatus = 'pending' | 'in_progress' | 'completed';\n```\n\n### TaskList Structure\n```typescript\ninterface TaskList {\n  id: string;                    // Unique list identifier\n  sessionId: string;             // Associated session ID\n  tasks: Task[];                 // Array of tasks\n  createdAt: Date;              // Creation timestamp\n  lastAccessed: Date;           // Last access timestamp\n}\n```\n\n---\n\n## 🏗️ Architecture Overview\n\n### System Components\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                   AI Assistant (Claude, GPT)                │\n└─────────────────────┬───────────────────────────────────────┘\n                      │ MCP Protocol\n┌─────────────────────▼───────────────────────────────────────┐\n│              SystemPrompt MCP TaskChecker                   │\n├─────────────────────────────────────────────────────────────┤\n│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │\n│  │   HTTP      │  │   Session   │  │    Task Service     │  │\n│  │  Transport  │  │  Manager    │  │                     │  │\n│  └─────────────┘  └─────────────┘  └─────────────────────┘  │\n│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │\n│  │   Tool      │  │   Config    │  │   In-Memory Store   │  │\n│  │  Handlers   │  │  Manager    │  │                     │  │\n│  └─────────────┘  └─────────────┘  └─────────────────────┘  │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### Technology Stack\n\n- **Runtime**: Node.js 18+\n- **Language**: TypeScript\n- **Protocol**: Model Context Protocol (MCP) 2025-03-26\n- **Transport**: Streamable HTTP\n- **Storage**: In-memory with automatic cleanup\n- **Framework**: Express.js\n- **Package Manager**: npm\n\n---\n\n## 🔒 Security \u0026 Compliance\n\n### Security Features\n- ✅ **Session Validation**: Cryptographically secure session IDs\n- ✅ **Input Validation**: Comprehensive parameter validation\n- ✅ **Error Handling**: Structured error responses without information leakage\n- ✅ **Rate Limiting Ready**: Architecture supports rate limiting implementation\n- ✅ **Transport Security**: HTTPS/TLS support for production deployments\n\n### Compliance Standards\n- **MCP Protocol Compliance**: Fully compatible with MCP 2025-03-26\n- **Data Privacy**: In-memory storage with automatic cleanup\n- **Enterprise Security**: Session-based isolation and validation\n\n---\n\n## 📈 Performance \u0026 Scaling\n\n### Performance Characteristics\n- **Memory Efficient**: In-memory storage with intelligent cleanup\n- **Low Latency**: Sub-millisecond response times for typical operations\n- **Concurrent Sessions**: Supports 1000+ simultaneous sessions\n- **Auto-Scaling Ready**: Stateless architecture compatible with horizontal scaling\n\n### Resource Limits\n| Resource | Default Limit | Configurable |\n|----------|---------------|--------------|\n| Max Tasks per List | 100 | ✅ |\n| Max Task Lists | 5 | ✅ |\n| Session Duration | 5 minutes | ✅ |\n| Concurrent Sessions | 1000 | ✅ |\n| Evaluation Range | 0-100 | ✅ |\n\n---\n\n## 🌐 Deployment Options\n\n### Production Deployment\n\n```bash\n# Environment variables\nexport NODE_ENV=production\nexport PORT=3000\nexport LOG_LEVEL=info\n\n# Start production server\nnpm start\n```\n\n### Docker Production\n\n```dockerfile\nFROM node:18-alpine\nWORKDIR /app\nCOPY . .\nRUN npm ci --only=production \u0026\u0026 npm run build\nEXPOSE 3000\nCMD [\"npm\", \"start\"]\n```\n\n### Cloud Integration\n- **AWS**: Compatible with ECS, Lambda, and EC2\n- **Google Cloud**: Supports Cloud Run, GKE, and Compute Engine\n- **Azure**: Works with Container Instances, AKS, and App Service\n- **Railway/Vercel**: One-click deployment ready\n\n---\n\n## 🧪 Testing \u0026 Quality Assurance\n\n### Test Coverage\n```bash\n# Unit tests\nnpm test\n\n# Integration tests\nnpm run test:client\n\n# Coverage report\nnpm run test:coverage\n\n# Development testing\nnpm run test:watch\n```\n\n### Quality Tools\n- **TypeScript**: Full type safety and compile-time checks\n- **ESLint**: Code quality and consistency enforcement\n- **Prettier**: Automated code formatting\n- **Jest**: Comprehensive testing framework\n\n---\n\n## 📚 API Documentation\n\n### Health Check Endpoints\n\n```http\nGET /health\n```\nReturns server health status and active session count.\n\n```http\nGET /sessions\n```\nLists active sessions (development/debugging).\n\n```http\nDELETE /sessions/:sessionId\n```\nManually cleanup specific session (testing).\n\n### MCP Endpoint\n\n```http\nPOST /mcp\n```\nMain MCP protocol endpoint for tool interactions.\n\n---\n\n## 🤝 Integration Examples\n\n### Claude Desktop Integration\n\nAdd to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"systemprompt-taskchecker\": {\n      \"command\": \"npx\",\n      \"args\": [\"systemprompt-mcp-taskchecker\"],\n      \"env\": {\n        \"NODE_ENV\": \"production\"\n      }\n    }\n  }\n}\n```\n\n### Custom AI Assistant Integration\n\n```javascript\nimport { MCPClient } from '@modelcontextprotocol/sdk/client/index.js';\n\nconst client = new MCPClient({\n  transport: new HTTPClientTransport('http://localhost:3000/mcp')\n});\n\n// Create task list\nconst result = await client.callTool('create_tasklist', {\n  initialTasks: [\n    {\n      title: 'Setup development environment',\n      acceptanceCriteria: 'All dependencies installed and tests passing'\n    }\n  ]\n});\n```\n\n---\n\n## 🎯 Use Cases\n\n### 🔧 **Development Workflows**\n- Track coding tasks and milestones\n- Manage code review requirements\n- Monitor deployment checklists\n- Evaluate task completion quality\n\n### 📋 **Project Management**\n- Structure project deliverables\n- Track acceptance criteria compliance\n- Generate progress reports\n- Maintain quality benchmarks\n\n### 🏢 **Enterprise Operations**\n- Standardize workflow processes\n- Implement quality gates\n- Track team performance metrics\n- Automate task orchestration\n\n### 🤖 **AI Assistant Enhancement**\n- Provide structured task context\n- Enable persistent workflow memory\n- Support complex multi-step processes\n- Facilitate evaluation and improvement\n\n---\n\n## 🛠️ Development \u0026 Contributing\n\n### Development Setup\n\n```bash\n# Fork and clone the repository\ngit clone https://github.com/YOUR_USERNAME/systemprompt-mcp-taskchecker.git\ncd systemprompt-mcp-taskchecker\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run dev\n\n# Run tests in watch mode\nnpm run test:watch\n```\n\n### Code Quality Standards\n- **TypeScript**: Strict mode enabled\n- **ESLint**: Airbnb configuration with custom rules\n- **Prettier**: Consistent code formatting\n- **Jest**: Minimum 80% test coverage\n- **Conventional Commits**: Standardized commit messages\n\n---\n\n## 📊 Monitoring \u0026 Observability\n\n### Built-in Monitoring\n- **Health Checks**: `/health` endpoint with detailed status\n- **Session Tracking**: Real-time active session monitoring\n- **Performance Metrics**: Request/response timing and success rates\n- **Error Tracking**: Structured error logging with session context\n\n### Logging Configuration\n```bash\n# Set log level\nexport LOG_LEVEL=debug  # debug, info, warn, error\n\n# Enable structured logging\nexport STRUCTURED_LOGS=true\n```\n\n---\n\n## 🌟 Why SystemPrompt.io?\n\n[**SystemPrompt.io**](https://systemprompt.io) is at the forefront of AI productivity innovation, creating enterprise-grade solutions that seamlessly bridge human intelligence with artificial intelligence. Our MCP TaskChecker represents our commitment to:\n\n- **🚀 Innovation**: Cutting-edge AI integration technologies\n- **🏢 Enterprise Focus**: Production-ready, scalable solutions\n- **🔒 Security First**: Built-in security and compliance features\n- **🌐 Open Standards**: Full Model Context Protocol compliance\n- **💡 Developer Experience**: Intuitive APIs and comprehensive documentation\n\n### Our Mission\n*Empowering organizations to harness the full potential of AI through intelligent workflow orchestration and productivity solutions.*\n\n---\n\n## 📞 Support \u0026 Resources\n\n### 🔗 **Quick Links**\n- **🏠 Homepage**: [https://systemprompt.io](https://systemprompt.io)\n- **📖 Documentation**: [https://systemprompt.io/docs/mcp-taskchecker](https://systemprompt.io/docs/mcp-taskchecker)\n- **💬 Support**: [https://systemprompt.io/support](https://systemprompt.io/support)\n- **🐛 Issues**: [GitHub Issues](https://github.com/Ejb503/systemprompt-mcp-taskchecker/issues)\n- **📧 Contact**: [ed@tyingshoelaces.com](mailto:ed@tyingshoelaces.com)\n\n### 🤝 **Community**\n- **GitHub Discussions**: Share ideas and ask questions\n- **Discord Server**: Real-time community support (coming soon)\n- **Blog**: Latest updates and tutorials at [systemprompt.io/blog](https://systemprompt.io/blog)\n\n---\n\n## 📄 License\n\n**MIT License**\n\n```\nCopyright 2025 SystemPrompt.io\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**🚀 Built with ❤️ by [SystemPrompt.io](https://systemprompt.io)**\n\n*Transforming AI productivity, one workflow at a time.*\n\n[![SystemPrompt.io](https://img.shields.io/badge/Powered%20by-SystemPrompt.io-blue?style=for-the-badge\u0026logoColor=white)](https://systemprompt.io)\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fejb503%2Fsystemprompt-mcp-taskchecker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fejb503%2Fsystemprompt-mcp-taskchecker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fejb503%2Fsystemprompt-mcp-taskchecker/lists"}