MCP服务器简单检查表
高级任务和项目管理MCP服务器，具有分层组织、人工智能驱动的规划和全面分析
🚀 快速开始
🌐 全栈Web应用程序（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备注：使用 mayurkakade/mcp-server:v1.0.2 对于解决了前端启动问题的特定固定版本。📡 仅限API模式（原始）：
# 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!对于开发者：
# 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📋 概述
SimpleCheckList是一个全面的模型上下文协议（MCP）服务器，为AI应用程序提供强大的项目管理功能。它具有分层组织系统、人工智能支持的规划辅助和实时分析功能。
🔧 最近更新（v1.0.2）
✅ Docker前端问题已修复：最新版本解决了所有Docker容器启动问题：
- 前端启动已修复：React应用程序现在可以在端口80上正常运行
- 后端API已修复：服务器正确启动并在端口8355上响应
- Nginx配置：解决了重定向循环和文件服务问题
- 两种服务都在工作：完整的全栈部署现在可以运行了
迁移：如果你在v1.0.1版本中遇到问题，只需拉取最新图像：
docker pull mayurkakade/mcp-server:latest🎯 主要特点
- 🌐 全栈Web用户界面：完整的基于React的项目管理界面（v1.0.2中已修复）
- ✅ Docker前端修复：解决了启动问题，前端和后端无缝工作
- 🔧 分级组织：项目→ 群组→ 任务列表→ 任务→ 子任务
- 🛠️ 20个综合工具：完成所有实体类型的CRUD操作
- 📊 5个资源端点：实时数据访问和分析
- 🤖 4个人工智能提示：智能规划和分析协助
- 🔒 企业安全：通过全面安全审计
- 🚀 多部署：Web UI、仅API、本地、Docker和云选项
🏗️ 建筑
Project
├── Groups (Frontend, Backend, Testing, etc.)
│ ├── Task Lists (User Auth, API Endpoints, etc.)
│ │ ├── Tasks (Individual work items)
│ │ │ └── Subtasks (Granular breakdown)🔧 安装
先决条件
- Node.js 18+（用于本地安装）
- Docker（用于容器化部署）
- SQLite3（用于本地安装）
方法一：Docker Hub（推荐）🐳
全栈Web应用程序（v1.0.2-推荐）：
# 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模式：
# 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 backendDocker编写（生产）：
# 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方法2：快速设置脚本
./setup.sh方法3：手动安装
# 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方法4：Docker编写
docker-compose up --build🤖 MCP集成
光标IDE配置
新 Cursor IDE用户的完整设置指南：
👉 光标MCP设置指南 -分步说明
快速设置:
- 转到光标设置→ MCP → 新建MCP服务器
- 姓名：
simple-checklist - 命令：
node - Args：
/path/to/SimpleCheckList/mcp-server/index.js - 环境：
API_BASE_URL=http://localhost:8355/api
Claude桌面配置
选项1:Docker（推荐）
{
"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"
]
}
}
}选项2：本地安装
{
"mcpServers": {
"simple-checklist": {
"command": "node",
"args": ["/path/to/SimpleCheckList/mcp-server/index.js"],
"env": {
"API_BASE_URL": "http://localhost:8355/api"
}
}
}
}可用工具（20）
项目管理
list_projects-获取所有包含元数据的项目create_project-创建新项目get_project-获取具体项目详细信息update_project-修改项目属性delete_project-删除项目和内容
任务管理
create_task-创建具有优先级、截止日期和元数据的任务list_tasks-获取特定任务列表的任务update_task-修改任务属性toggle_task_completion-标记任务已完成/未完成delete_task-删除任务和子任务
分析
get_project_stats-综合项目统计get_all_tasks-全系统任务分析
资源端点（5）
checklist://projects-所有带有元数据的项目checklist://tasks/all-跨项目的所有任务checklist://stats/summary-全系统统计checklist://projects/{id}-具体项目细节checklist://projects/{id}/hierarchy-完整的项目结构
人工智能提示（4）
create_project_plan-自动生成项目结构analyze_project_progress-智能进度分析suggest_task_breakdown-智能任务分解generate_status_report-综合报告
🌐 Web UI功能（v1.0.2+-工作）
全栈部署包括一个完整的基于React的web界面，修复了所有启动问题：
📋 项目管理仪表板
- 可视化项目概述：查看所有有进度指标的项目
- 分层任务组织：从项目深入到子任务
- 实时更新：实时进度跟踪和完成状态
- 响应式设计：适用于台式机、平板电脑和移动设备
🎯 任务管理界面
- 拖放：直观的任务组织和优先级
- 丰富的任务详细信息：添加描述、截止日期、优先级和元数据
- 进度跟踪：视觉完成指标和统计数据
- 搜索和筛选：跨项目快速查找任务
📊 分析和报告
- 项目统计：完成率、任务分配、进度图
- 时间跟踪：到期日管理和截止日期监控
- 导出功能：生成报告和导出数据
🔧 管理功能
- 用户管理：基于角色的访问的多用户支持
- 设置面板：配置首选项和系统设置
- 数据导入/导出：备份和恢复项目数据
📖 使用示例
Web UI使用情况
- 启动应用程序:
docker run -d -p 8080:80 -p 8355:8355 mayurkakade/mcp-server:latest - 打开浏览器：导航到
http://localhost:8080 - 创建您的第一个项目：单击“新建项目”并按照向导进行操作
- 分组组织：添加前端、后端、测试组
- 添加任务列表：在组内创建特定功能列表
- 追踪进度：标记任务完成并查看进度指标更新
备注：v1.0.2解决了所有Docker前端启动问题-UI和API都能无缝工作！
API用法-创建Web应用程序项目
// 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"
]
}
})人工智能辅助规划
// 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"
})🔒 安全
SimpleCheckList已经过全面的安全审计：
- ✅ 无关键漏洞
- ✅ 输入验证和消毒
- ✅ SQL注入保护
- ✅ 安全错误处理
- ✅ 企业级控制
📊 api参考
REST API端点
- 项目:
/api/projects - 群组:
/api/projects/:id/groups - 任务列表:
/api/groups/:id/task-lists - 任务:
/api/task-lists/:id/tasks - 子任务:
/api/tasks/:id/subtasks
🚀 部署
地方发展
npm run dev
# Backend: http://localhost:8355
# Frontend: http://localhost:8354Docker生产
docker-compose up --build环境变量
# Backend API URL for MCP server
API_BASE_URL=http://localhost:8355/api
# Database path (optional)
DATABASE_PATH=./data/checklist.db📚 文档
🎯 人类MCP注册表
简单清单是 准备提交 向Anthropic MCP注册表发送：
- ✅ MCP规范合规性
- ✅ 安全审计通过
- ✅ 全面的文件
- ✅ 注册表清单已准备就绪
- ✅ 生产部署已测试
🤝 贡献
我们欢迎捐款！请查看我们的 贡献指南 了解详情。
- 复刻仓库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
📝 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🆘 支持
- 文档：查看我们上面的综合指南
- 问题:
- 讨论:
🏆 致谢
______________________________________________________________________
Ready for AI-powered project management? Get started today!