项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1194
使用教程
环境要求
- Docker 环境(官方推荐的部署方式,镜像已包含全部组件)
- 一个可访问的 MySQL 数据库,并提供连接串
- Node.js 与 npm(用于安装 @todo-for-ai/mcp 或构建前端/MCP)
- Python 3 与 pip(仅源码方式运行 Flask 后端时需要)
安装与启动步骤
-
1Docker 一键启动
拉取并后台运行官方镜像,映射 50111(Web) 与 50110(API) 端口,需替换数据库、邮箱与密钥等占位值。
docker run -d --name todo-for-ai \ -p 50111:80 \ -p 50110:50110 \ -e DATABASE_URL="mysql+pymysql://username:password@host.docker.internal:3306/todo_for_ai" \ -e GMAIL_USER="your-email@gmail.com" \ -e GMAIL_PASSWORD="your-app-password" \ -e GITHUB_TOKEN="your-github-token" \ -e SECRET_KEY="your-secret-key-here" \ -e JWT_SECRET_KEY="your-jwt-secret-key-here" \ --add-host=host.docker.internal:host-gateway \ todoforai/todo-for-ai:latest -
2Docker Compose 启动
开发者方式:复制环境变量模板并编辑后,用 compose 在仓库中一键起服务。
cp .env.example .env docker-compose up -d -
3安装 MCP 服务
通过 npm 全局安装 MCP 包,让 Cursor、Windsurf、Trae 等 AI 工具接入任务管理能力。
npm install -g @todo-for-ai/mcp -
4编写 MCP 配置
在 config.json 中填写 MCP 主机端口、后端 API 地址、JWT token 与功能开关后供 AI 工具加载。
-
5源码部署后端
递归克隆仓库,进入 API 子目录安装依赖并启动 Flask 后端。
git clone --recursive https://github.com/todo-for-ai/todo-for-ai.git cd todo-for-ai/todo-for-ai-api-server pip install -r requirements.txt python app.py -
6源码部署前端
新开一个终端,进入前端目录安装依赖、构建并预览 Web 界面。
cd ../todo-for-ai-webpage npm install npm run build npm run preview -
7源码部署 MCP
再开一个终端,进入 MCP 目录安装依赖、构建并启动 MCP 服务。
cd ../todo-for-ai-mcp npm install npm run build npm start
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
DATABASE_URL | 是 | 后端连接的 MySQL 数据库连接串 | mysql+pymysql://username:password@host.docker.internal:3306/ |
GMAIL_USER | 否 | 用于发送邮件通知的 Gmail 账号 | your-email@gmail.com |
GMAIL_PASSWORD | 否 | Gmail 应用专用密码,需开启两步验证后生成 | your-app-password |
GITHUB_TOKEN | 否 | GitHub 个人访问令牌,用于仓库相关集成 | your-github-token |
SECRET_KEY | 是 | 应用加密密钥,生产环境必须改为强随机值 | your-secret-key-here |
JWT_SECRET_KEY | 是 | JWT 签发密钥,用于登录态校验 | your-jwt-secret-key-here |
如何确认成功
浏览器访问 http://localhost:50111 能看到 Web 界面,并用 lsof -i :50110 和 lsof -i :50111 确认端口已被监听。
常见问题
Q:容器启动后连不上数据库怎么办?
A:确认 MySQL 已启动且允许远程连接;Docker 方式需保留 --add-host=host.docker.internal:host-gateway,并把 DATABASE_URL 中的主机写成 host.docker.internal。
Q:50110 或 50111 端口被占用怎么办?
A:用 lsof -i :50110 和 lsof -i :50111 查出占用进程并停止,或改用其他宿主机端口重新运行容器。
Q:如何配置 GitHub 登录?
A:在 GitHub Developer Settings 新建 OAuth App,Homepage URL 填 http://localhost:50111,回调地址填 http://localhost:50110/todo-for-ai/api/v1/auth/callback,再把 Client ID 与 Secret 配好。
Q:MCP 连不上后端接口?
A:检查 config.json 中 api.baseUrl 是否为 http://localhost:50110/todo-for-ai/api/v1,并确认 auth.token 是有效的 JWT。
注意事项
- Docker 部署必须加 --add-host=host.docker.internal:host-gateway,否则容器内无法访问宿主机上的 MySQL。
- 生产环境请把 SECRET_KEY、JWT_SECRET_KEY 换成复杂强密码,并配置 HTTPS 与数据库自动备份。
- Gmail 发送邮件需先开启两步验证并生成应用专用密码,不能直接使用账号登录密码。
- 源码方式会同时运行后端、前端和 MCP 三个服务,需要在三个独立终端中分别启动。
核心亮点
- 通过 MCP 协议直接接入 Cursor、Windsurf 等主流 AI 编码工具,AI 可自主读写任务
- 同时覆盖项目、任务、团队协作三层,不只是简单待办清单
- 提供 Docker 部署和在线试用站点,上手门槛低
不足之处
- 生态较新,MCP 客户端兼容性和长期维护节奏待观察
- 团队协作的权限、通知等细节功能相比成熟项目管理工具仍偏薄
适用场景
- 用 Cursor 开发时让 AI 自动拆解并跟踪多步任务
- 小团队共享项目看板,AI 与人类同步更新进度
- 给 AI Agent 提供持久化任务记忆,跨会话续接工作
替代项目
Vikunja、Focalboard
上一篇:BeatDesign
同类项目推荐
open-computer-use
开源
用开源大模型驱动 AI 自动操作电脑,摆脱闭源限制
AI computer use powered by open source LLMs and E2B Desktop Sandbox
dark-factory-experiment
开源
AI 自己看 issue、写代码、审完自动合并
A repository that ships its own code. AI workflows triage issues, implement them, re···
wmux
开源
在 Windows 上像 tmux 一样同时管理多个 AI 编码代理
The original Windows terminal multiplexer for AI agents.
lobster
开源
把多个工具串成一条流水线,Openclaw 一步调用
Lobster is a Openclaw-native workflow shell: a typed, local-first “macro engine” t···
super-board
开源
一行安装,让 Claude Code 自动把看板任务做成代码并自检评审
Autonomous GitHub Project build → QA → review loop for Claude Code. One-line insta···
squirrelscan
开源
一条命令让 AI 代理给网站做 300 项体检
The website QA tool for your coding agent. 350+ audit rules across SEO, performance,···
dagu
开源
用 YAML 编排脚本和 AI 代理,一个二进制搞定,无需数据库。
Self-hostable workflow orchestrator for teams whose main work isn't orchestration. D···
WebRPA
开源
拖拽模块搭流程,不写代码搞定网页采集与自动化
A powerful no-code automation tool. Build workflows via drag-and-drop modules for we···
jev-browser
开源
让 AI 选控件,Playwright 执行,浏览器自动化更稳
Jev Browser — indexed browser automation. Jev chooses the control, Playwright acts.···
