Todo Assistant with AI and Google Calendar Integration

Todo Assistant 与 Google Calendar 集成

一款现代化的 AI 驱动待办事项列表和日历管理应用，结合了 OpenAI 的 Assistant API 与 Google Calendar 集成。使用 TypeScript 构建，同时提供 MCP（Model Context Protocol）和传统 API 端点。

Todo Assistant 主界面

Todo Assistant 主界面

Todo Assistant 主界面

🌟 主要功能

• AI 驱动的聊天界面：使用 OpenAI 的 GPT-3.5 Turbo 进行自然语言交互
• 智能待办事项管理：使用自然语言添加、删除、列出和切换待办事项状态
• Google Calendar 集成：将待办事项与 Google Calendar 无缝同步
• 多语言支持：全面支持英语和土耳其语
• 工具审批系统：为敏感操作提供安全的审批工作流
• MCP（Model Context Protocol）：标准化的 AI 工具交互
• 响应式设计：现代化、适配移动设备的 Web 界面
• 持久化存储：使用 SQLite 数据库可靠地管理数据

🛠️ 技术栈

• 后端：

  • Node.js 与 Express
  • TypeScript
  • SQLite（通过 better-sqlite3）
  • OpenAI Assistant API
  • Google Calendar API

• 前端：

  • HTML5 和 CSS3
  • 现代 JavaScript
  • 响应式设计

• AI 与集成：

  • OpenAI GPT-3.5 Turbo
  • Model Context Protocol（MCP）
  • 用于 Google Calendar 的 OAuth 2.0

📋 前置条件

• Node.js（v16 或更高版本）
• npm 或 yarn
• OpenAI API 密钥
• Google Cloud Console 账号
• SQLite

🚀 开始使用

1. 克隆仓库

   git clone https://github.com/yourusername/todo-assistant.git
   cd todo-assistant
   

2. 安装依赖

   npm install
   

3. 配置环境 在根目录中创建一个 .env 文件：

   OPENAI_API_KEY=your_openai_api_key
   PORT=3000
   CLIENT_ID=your_google_client_id
   CLIENT_SECRET=your_google_client_secret
   GOOGLE_REDIRECT_URI=http://localhost:3000/google/callback
   

4. 构建并运行

   # Build TypeScript
   npm run build
   
   # Start server
   npm start
   
   # Development mode with auto-reload
   npm run dev
   
   # Start with MCP enabled
   npm run dev:mcp
   

🗄️ 数据库结构

待办事项表

CREATE TABLE todos (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    text TEXT NOT NULL,
    completed BOOLEAN NOT NULL DEFAULT 0,
    createdAt TEXT NOT NULL
)

日历事件表

CREATE TABLE calendar_events (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    todoId INTEGER NOT NULL,
    title TEXT NOT NULL,
    date TEXT NOT NULL,
    time TEXT NOT NULL,
    createdAt TEXT NOT NULL,
    FOREIGN KEY (todoId) REFERENCES todos(id) ON DELETE CASCADE
)

🔌 API 端点

传统 REST API

• POST /api/thread - 创建或获取用户会话
• POST /api/chat - 发送或接收消息
• GET /api/history/:userId - 获取聊天记录
• POST /api/tool-response - 处理工具审批

MCP 端点

• POST /mcp - MCP 主交互端点
• GET /mcp/health - 健康检查
• GET /mcp/tools - 可用工具列表

💡 使用示例

英语命令

"Add 'Buy groceries' to my todo list"
"Show all my todos"
"Mark todo #3 as complete"
"Add 'Team meeting' to calendar for tomorrow at 2pm"
"Show my calendar events for next week"

土耳其语命令

"Alışveriş yapmayı listeye ekle"
"Tüm görevlerimi göster"
"3 numaralı görevi tamamlandı olarak işaretle"
"Yarın saat 14:00'da takım toplantısını takvime ekle"
"Gelecek haftaki takvim etkinliklerimi göster"

🔒 安全功能

• 针对敏感操作的工具审批工作流
• 用于 Google Calendar 的 OAuth 2.0 身份验证
• 安全的凭据管理
• 输入验证和清理

🌐 Google Calendar 设置

1. 前往 Google Cloud Console
2. 创建新项目或选择现有项目
3. 启用 Google Calendar API
4. 配置 OAuth 2.0 凭据：
   • 将应用类型设为“Web application”
   • 添加已获授权的重定向 URI：http://localhost:3000/google/callback
   • 下载凭据并更新 .env 文件

🤝 参与贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 创建 Pull Request

📝 许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。

🙏 致谢

• 感谢 OpenAI 提供强大的 Assistant API
• 感谢 Google Calendar API 团队
• 感谢贡献者和测试人员

📞 支持

如需支持，请在 GitHub 仓库中提交 issue，或联系维护者。