星战科技xingzhan.cloud
返回市场
简易检查列表

简易检查列表

作者：DevMayur4 星标更新：2025-09-22
安装使用来源：spider==github.com

项目介绍

<div align="center">

SimpleCheckList 图标

SimpleCheckList MCP 服务器

MCP 注册准备就绪 Docker Hub 安全审计 许可证：MIT

具有分层组织、AI驱动规划和全面分析的高级任务和项目管理MCP服务器

</div>

🚀 快速开始

🌐 全栈Web应用程序（已在v1.0.2中修复）：

# 完整的项目管理应用程序，包括Web界面和API
docker run -d -p 8080:80 -p 8355:8355 mayurkakade/mcp-server:latest

# 访问：
# - Web界面：http://localhost:8080（完整的项目管理界面）
# - API：http://localhost:8355/api（MCP服务器端点）
# - 健康检查：http://localhost:8355/api/health

注意：使用mayurkakade/mcp-server:v1.0.2以解决前端启动问题。

📡 API仅模式（原始）：

# 后端API服务器（用于MCP集成）
docker run -p  8355:8355 mayurkakade/mcp-server:latest backend

# 在http://localhost:8355/api/health访问API
# MCP服务器已准备好与Claude Desktop集成！

开发者指南：

# 克隆仓库进行开发
git clone https://github.com/DevMayur/SimpleCheckList.git
cd SimpleCheckList

# 快速设置（安装依赖并初始化数据库）
./setup.sh

# 启动全栈应用
npm run dev

📋 概览

SimpleCheckList是一个全面的模型上下文协议（MCP）服务器，为AI应用程序提供强大的项目管理能力。它具有分层组织系统、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个AI驱动提示：智能规划和分析辅助
  • 🔒 企业级安全：通过了全面的安全审计
  • 🚀 多种部署方式：Web界面、API仅模式、本地、Docker和云选项

🏗️ 架构

项目
├── 组（前端、后端、测试等）
│   ├── 任务列表（用户认证、API端点等）
│   │   ├── 任务（单独的工作项）
│   │   │   └── 子任务（细粒度分解）

🔧 安装

预备条件

  • Node.js 18+（用于本地安装）
  • Docker（用于容器化部署）
  • SQLite3（用于本地安装）

方法1：Docker Hub（推荐） 🐳

全栈Web应用程序（v1.0.2 - 推荐）：

# 包含Web界面和API的完整应用程序 - 已修复版本
docker run -d --name simplechecklist-fullstack \
    -p 8080:80 \
    -p 8355:8355 \
    -v simplechecklist_data:/app/data \
    --restart unless-stopped \
    mayurkakade/mcp-server:latest

# 访问：
# - Web界面：http://localhost:8080
# - API：http://localhost:8355/api

# 对于特定版本：
# mayurkakade/mcp-server:v1.0.2 （推荐 - 解决了前端问题）

API仅模式：

# 后端API服务器（用于MCP集成）
docker run -d --name simplechecklist-api \
    -p 8355:8355 \
    -v simplechecklist_data:/app/data \
    --restart unless-stopped \
    mayurkakade/mcp-server:latest backend

Docker Compose（生产环境）：

# 使用全栈compose文件
docker-compose -f docker-compose.fullstack.yml up -d

# 访问：
# - Web界面：http://localhost:8080
# - API：http://localhost:8355/api

方法2：快速设置脚本

./setup.sh

方法3：手动安装

# 安装依赖
npm install
cd server && npm install
cd ../client && npm install  
cd ../mcp-server && npm install

# 初始化数据库
cd server && npm run init-db

# 启动服务
cd .. && npm run dev

方法4：Docker Compose

docker-compose up --build

🤖 MCP集成

Cursor IDE配置

新！ 适用于Cursor IDE用户的完整设置指南：

👉 Cursor MCP设置指南 - 步骤说明

快速设置：

  1. 转到Cursor设置 → MCP → 新MCP服务器
  2. 名称：simple-checklist
  3. 命令：node
  4. 参数：/path/to/SimpleCheckList/mcp-server/index.js
  5. 环境变量：API_BASE_URL=http://localhost:8355/api

Claude Desktop配置

选项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 - 完整的项目结构

AI驱动提示（4个）

  • create_project_plan - 自动生成项目结构
  • analyze_project_progress - 智能进度分析
  • suggest_task_breakdown - 智能任务分解
  • generate_status_report - 综合报告生成

🌐 Web界面特性（v1.0.2+ - 工作正常）

全栈部署包括一个完整的基于React的Web界面，所有启动问题均已修复：

📋 项目管理仪表板

  • 可视化项目概览：查看所有项目及其进度指示器
  • 分层任务组织：从项目钻取到子任务
  • 实时更新：实时进度跟踪和完成状态
  • 响应式设计：适用于桌面、平板和移动设备

🎯 任务管理界面

  • 拖放：直观的任务组织和优先级排序
  • 丰富的任务详情：添加描述、截止日期、优先级和元数据
  • 进度跟踪：视觉完成指示器和统计信息
  • 搜索和筛选：快速跨项目查找任务

📊 分析和报告

  • 项目统计：完成率、任务分布、进度图表
  • 时间跟踪：截止日期管理和期限监控
  • 导出功能：生成报告和导出数据

🔧 管理员功能

  • 用户管理：多用户支持，基于角色的访问
  • 设置面板：配置偏好和系统设置
  • 数据导入/导出：备份和恢复项目数据

📖 使用示例

Web界面使用

  1. 启动应用程序：docker run -d -p 8080:80 -p 8355:8355 mayurkakade/mcp-server:latest
  2. 打开浏览器：导航至http://localhost:8080
  3. 创建第一个项目：点击“新建项目”并跟随向导
  4. 组织成组：添加前端、后端、测试组
  5. 添加任务列表：在组内创建特定的功能列表
  6. 跟踪进度：标记任务完成并观察进度指示器更新

注意：v1.0.2解决了所有Docker前端启动问题 - 界面和API无缝协作！

API使用 - 创建Web应用程序项目

// 1. 创建项目
create_project({
  name: "电子商务平台",
  description: "使用React和Node.js的全栈电子商务",
  color: "#2563EB"
})

// 2. 创建组
create_group({
  project_id: "project-id",
  name: "前端",
  description: "React UI组件"
})

// 3. 创建带有丰富元数据的任务
create_task({
  task_list_id: "task-list-id",
  title: "实现用户认证",
  description: "完成JWT认证系统",
  priority: "高",
  metadata: {
    files: ["auth.service.ts", "login.component.tsx"],
    acceptance_criteria: [
      "JWT令牌生成",
      "受保护的路由",
      "密码验证"
    ]
  }
})

AI辅助规划

// 获取AI帮助进行项目规划
create_project_plan({
  project_name: "移动应用开发",
  complexity: "复杂"
})

// 分析项目进度
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

完整API文档 →

🚀 部署

本地开发

npm run dev
# 后端：http://localhost:8355
# 前端：http://localhost:8354

Docker生产环境

docker-compose up --build

环境变量

# MCP服务器的后端API URL
API_BASE_URL=http://localhost:8355/api

# 数据库路径（可选）
DATABASE_PATH=./data/checklist.db

📚 文档

🎯 Anthropic MCP注册

SimpleCheckList已准备好提交到Anthropic MCP注册：

  • ✅ 符合MCP规范
  • ✅ 通过了安全审计
  • ✅ 提供了全面文档
  • ✅ 准备好了注册清单
  • ✅ 测试了生产部署

查看注册提交指南 →

🤝 贡献

我们欢迎贡献！请参阅我们的贡献指南了解详情。

  1. 分叉仓库
  2. 创建功能分支（git checkout -b feature/amazing-feature）
  3. 提交更改（git commit -m '添加惊人的功能'）
  4. 推送到分支（git push origin feature/amazing-feature）
  5. 打开Pull Request

📝 许可证

本项目采用MIT许可证 - 查看LICENSE文件获取详细信息。

🆘 支持

🏆 致谢

<div align="center"> <strong>准备好使用AI驱动的项目管理了吗？今天就开始吧！</strong> </div>