Todo AI Chatbot

所有查特博特

一个由人工智能驱动的Todo聊天机器人，用户可以通过自然语言管理任务。使用OpenAI代理SDK（使用Gemini API后端）和MCP构建任务操作。

建筑

ChatKit (UI) → FastAPI (Backend) → OpenAI Agent → MCP Server → Neon PostgreSQL

快速开始

看 规格/001人工智能聊天机器人/quickstart.md 有关设置说明。

项目结构

backend/           # FastAPI server + Agent
├── src/
│   ├── api/       # FastAPI routes
│   ├── models/    # SQLModel models
│   ├── services/  # Agent and conversation logic
│   ├── auth/      # Better Auth configuration
│   └── db/        # Database connection and migrations
└── tests/

mcp/               # MCP Server (Official SDK)
├── src/
│   ├── server.py  # MCP server
│   └── tools/     # MCP tools (add, list, update, complete, delete)
└── tests/

frontend/          # ChatKit React UI
├── src/
│   ├── components/
│   └── services/
└── package.json

主要特点

• 单聊天端点： POST /api/{user_id}/chat
• 5个MCP工具：添加任务、列表任务、更新任务、完成任务、删除任务
• 具有Neon PostgreSQL持久性的无状态后端
• 自然多回合对话的对话语境

环境变量

# backend/.env
GEMINI_API_KEY=your-gemini-api-key
DATABASE_URL=postgresql+asyncpg://user:pass@host/db

# mcp/.env
DATABASE_URL=postgresql+asyncpg://user:pass@host/db

宪法

本项目遵循 .define/memory/constitution.md.