Todo Assistant with AI and Google Calendar Integration

Todo Assistant with AI and Google Calendar Integration

site icon
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 凭证。

🚀 使用教程

使用依赖

  1. 安装 Node.js(v16 或更高版本) bash # 在 Ubuntu 上安装 Node.js sudo apt update sudo apt install nodejs sudo apt install npm
  2. 安装 SQLite bash # 在 Ubuntu 上安装 SQLite sudo apt install sqlite3

安装教程

  1. 克隆仓库 bash git clone https://github.com/yourusername/todo-assistant.git cd todo-assistant
  2. 安装依赖 bash npm install
  3. 环境配置 创建 .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
  4. 构建和运行 ```bash # 构建 TypeScript npm run build

# 启动服务器 npm start

# 开发模式(自动重载) npm run dev

# 启用 MCP 模式 npm run dev:mcp ```

调试方式

  1. 检查服务器是否运行 bash curl http://localhost:3000/mcp/health
  2. 测试 API 端点 bash curl -X POST http://localhost:3000/api/thread
  3. 检查数据库 bash sqlite3 database.db "SELECT * FROM todos;"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。