Todo Assistant与人工智能和谷歌日历集成
一个现代的、人工智能驱动的待办事项列表和日历管理应用程序，结合了OpenAI的Assistant API和谷歌日历集成。采用TypeScript构建，同时具有MCP（模型上下文协议）和传统的API端点。
Todo Assistant Main Screen
Todo Assistant Main Screen
Todo Assistant Main Screen
🌟 主要特点
- 人工智能聊天界面：使用OpenAI的GPT-3.5 Turbo进行自然语言交互
- 智能待办事项管理：使用自然语言添加、删除、列出和切换待办事项
- 谷歌日历集成：与谷歌日历无缝同步待办事项
- 多语言支持：全力支持英语和土耳其语
- 工具审批系统：为敏感操作提供安全的审批工作流程
- MCP（模型上下文协议）：标准化的人工智能工具交互
- 响应式设计：现代、移动友好的网络界面
- 永久存储：SQLite数据库，用于可靠的数据管理
🛠️ 技术栈
- 后端:
- Node.js与Express - TypeScript - SQLite（通过better-squarite3） - OpenAI助手API - 谷歌日历API
- 前端:
- HTML5和CSS3 - 现代JavaScript - 响应式设计
- 人工智能与集成:
- OpenAI GPT-3.5 Turbo - 模型上下文协议（MCP） - OAuth 2.0用于谷歌日历
📋 先决条件
- Node.js（v16或更高版本）
- npm或纱线
- OpenAI API密钥
- 谷歌云控制台帐户
- 数据库
🚀 入门指南
- 克隆存储库
git clone https://github.com/yourusername/todo-assistant.git
cd todo-assistant- 再进行
npm install- 环境设置
创建一个 .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- 构建并运行
# 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日历的OAuth 2.0身份验证
- 安全的凭证管理
- 输入验证和净化
🌐 谷歌日历设置
- 首选 谷歌云控制台
- 创建新项目或选择现有项目
- 启用Google日历API
- 配置OAuth 2.0凭据：
- 将应用程序类型设置为“Web应用程序” - 添加授权重定向URI： http://localhost:3000/google/callback - 下载凭据并更新 .env 文件
🤝 贡献
- 分叉存储库
- 创建功能分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'Add some AmazingFeature') - 推到分支(
git push origin feature/AmazingFeature) - 打开拉取请求
📝 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
- OpenAI为其强大的助手API
- Google日历API团队
- 贡献者和测试者
📞 支持
如需支持，请在GitHub存储库中打开问题或联系维护人员。
