todo-for-ai

让 AI 助手自己管任务,项目进度不再丢在对话里

开源 🏷️定价信息待确认 🚫 站点已失效 自动化工作流 🍴 复刻 106 🐛 待处理 1 👀 关注 76
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1194
维护状态 维护中
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

todo-for-ai 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队todo-for-ai
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态🚫 站点已失效
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型ai-coding-tools,cursor,kiro,todo4ai,trae,windsurf
GitHub 星标★ 1194
上线时间2025-07-28 00:00:00
代码更新2026-09-19
仓库体积105.9 MB
本站数据更新2026-11-22
维护状态维护中
收录时间2026-10-08
浏览次数3

项目介绍

todo-for-ai 是一套专为 AI 助手设计的任务管理系统,解决 AI 编程助手在长任务、多项目协作中缺乏统一任务追踪与上下文记忆的问题。它通过 MCP(模型上下文协议)把任务管理能力直接暴露给 Cursor、Windsurf、Trae、Kiro 等 AI 编码工具,让 AI 能自主创建、查询、更新任务和项目进度。核心能力包括:项目管理、任务跟踪、团队协作、与 AI 工具的无缝集成,并支持 Docker 一键部署。后端用 Flask,前端用 React,整体技术栈现代且轻量。对于需要让 AI 参与实际开发流程、又希望任务状态可追溯的团队来说,它相当于给 AI 助手配了一套共享的待办清单和项目看板,避免任务散落在对话里丢失。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1194

使用教程

难度:入门 约 15 分钟 部署方式:Docker 7 步

环境要求

  • Docker 环境(官方推荐的部署方式,镜像已包含全部组件)
  • 一个可访问的 MySQL 数据库,并提供连接串
  • Node.js 与 npm(用于安装 @todo-for-ai/mcp 或构建前端/MCP)
  • Python 3 与 pip(仅源码方式运行 Flask 后端时需要)

安装与启动步骤

  1. 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
  2. 2Docker Compose 启动

    开发者方式:复制环境变量模板并编辑后,用 compose 在仓库中一键起服务。

    cp .env.example .env
    docker-compose up -d
  3. 3安装 MCP 服务

    通过 npm 全局安装 MCP 包,让 Cursor、Windsurf、Trae 等 AI 工具接入任务管理能力。

    npm install -g @todo-for-ai/mcp
  4. 4编写 MCP 配置

    在 config.json 中填写 MCP 主机端口、后端 API 地址、JWT token 与功能开关后供 AI 工具加载。

  5. 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. 6源码部署前端

    新开一个终端,进入前端目录安装依赖、构建并预览 Web 界面。

    cd ../todo-for-ai-webpage
    npm install
    npm run build
    npm run preview
  7. 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

下一篇:dingtalk-workspace-cli

同类项目推荐

open-computer-use 开源

用开源大模型驱动 AI 自动操作电脑,摆脱闭源限制

AI computer use powered by open source LLMs and E2B Desktop Sandbox

★ 2412 2026-08-09
dark-factory-experiment 开源

AI 自己看 issue、写代码、审完自动合并

A repository that ships its own code. AI workflows triage issues, implement them, re···

★ 177 2026-09-12
wmux 开源

在 Windows 上像 tmux 一样同时管理多个 AI 编码代理

The original Windows terminal multiplexer for AI agents.

★ 450 2026-09-22
lobster 开源

把多个工具串成一条流水线,Openclaw 一步调用

Lobster is a Openclaw-native workflow shell: a typed, local-first “macro engine” t···

★ 1282 2026-10-07
super-board 开源

一行安装,让 Claude Code 自动把看板任务做成代码并自检评审

Autonomous GitHub Project build → QA → review loop for Claude Code. One-line insta···

★ 724 2026-10-18
squirrelscan 开源

一条命令让 AI 代理给网站做 300 项体检

The website QA tool for your coding agent. 350+ audit rules across SEO, performance,···

★ 321 2026-10-24
dagu 开源

用 YAML 编排脚本和 AI 代理,一个二进制搞定,无需数据库。

Self-hostable workflow orchestrator for teams whose main work isn't orchestration. D···

★ 4642 2026-08-09
WebRPA 开源

拖拽模块搭流程,不写代码搞定网页采集与自动化

A powerful no-code automation tool. Build workflows via drag-and-drop modules for we···

★ 1918 2026-09-29
jev-browser 开源

让 AI 选控件,Playwright 执行,浏览器自动化更稳

Jev Browser — indexed browser automation. Jev chooses the control, Playwright acts.···

★ 9 2026-09-27