
Todo Assistant with AI and Google Calendar Integration

2025.03.18
1
TypeScriptAI 待办事项管理Google Calendar 集成多语言支持MCP 协议日程管理开发效率
Mcp-Server_OpenAI-Chat 是一个结合了 OpenAI 的 Assistant API 和 Google Calendar 集成的现代 AI 待办事项和日历管理应用程序。它采用 TypeScript 构建,支持 MCP(Model Context Protocol)和传统 API 端点。该应用提供自然语言交互、智能待办事项管理、Google Calendar 同步、多语言支持等功能。
View on GitHub
Overview
🌟 基本能力
产品定位
Mcp-Server_OpenAI-Chat 是一个 AI 驱动的待办事项和日历管理工具,旨在通过自然语言交互提升用户的生产力和日程管理效率。
核心功能
- AI 驱动的聊天界面:使用 OpenAI 的 GPT-3.5 Turbo 进行自然语言交互。
- 智能待办事项管理:通过自然语言添加、删除、列出和切换待办事项。
- Google Calendar 集成:无缝将待办事项同步到 Google Calendar。
- 多语言支持:支持英语和土耳其语。
- 工具批准系统:敏感操作的安全审批流程。
- MCP(Model Context Protocol):标准化的 AI 工具交互。
- 响应式设计:现代、移动友好的网页界面。
- 持久化存储:使用 SQLite 数据库进行可靠的数据管理。
适用场景
- 个人日程管理
- 团队协作和任务分配
- 多语言环境下的任务管理
- 需要与 Google Calendar 同步的任务管理
工具列表
- OpenAI GPT-3.5 Turbo:提供自然语言处理能力。
- Google Calendar API:用于日程同步。
- SQLite:用于数据持久化存储。
常见问题解答
- 如何获取 OpenAI API 密钥?:需要在 OpenAI 官网注册并获取 API 密钥。
- 如何配置 Google Calendar API?:需要在 Google Cloud Console 中启用 Google Calendar API 并配置 OAuth 2.0 凭证。
🚀 使用教程
使用依赖
- 安装 Node.js(v16 或更高版本)
bash # 在 Ubuntu 上安装 Node.js sudo apt update sudo apt install nodejs sudo apt install npm
- 安装 SQLite
bash # 在 Ubuntu 上安装 SQLite sudo apt install sqlite3
安装教程
- 克隆仓库
bash git clone https://github.com/yourusername/todo-assistant.git cd todo-assistant
- 安装依赖
bash npm install
- 环境配置
创建
.env
文件并填写以下内容: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
- 构建和运行 ```bash # 构建 TypeScript npm run build
# 启动服务器 npm start
# 开发模式(自动重载) npm run dev
# 启用 MCP 模式 npm run dev:mcp ```
调试方式
- 检查服务器是否运行
bash curl http://localhost:3000/mcp/health
- 测试 API 端点
bash curl -X POST http://localhost:3000/api/thread
- 检查数据库
bash sqlite3 database.db "SELECT * FROM todos;"