Google Calander MCP Server

谷歌日历MCP服务器

您的个人AI助手，用于谷歌日历和谷歌文档。

谷歌日历MCP是一个开源服务器，可以将自然语言转化为结构化的日程和笔记。它由现代LLM和模型控制协议（MCP）提供支持，可以帮助您自动计划、记忆和反思。

______________________________________________________________________

特性

• 自然语言议程解析\

“下周四下午2点与Sam见面喝咖啡”→ 谷歌日历事件+提醒

• 谷歌文档日志\

“每周日写一篇每周反思”→ 自动生成的文档+带时间戳的条目

• 提醒工作\

自动设置提醒：活动前1天1小时（或自定义）

• 模型灵活（GPT、Claude、Gemini）\

带上自己的LLM，并通过适配器将其插入

• 隐私第一\

自托管，可完全控制您的数据和API

______________________________________________________________________

架构文档

此存储库包含Google Calendar MCP服务器的全面架构文档：

• 架构概述 -系统架构、组件和数据流
• 技术栈 -详细的技术建议和原理
• 文件结构 -推荐的项目组织
• 模块详细信息 -核心模块实施指南
• 数据流 -关键系统交互的序列图

系统架构

谷歌日历MCP遵循模块化架构，组件之间有明确的界限：

graph TB
    subgraph "Client Layer"
        CLI[Command Line Interface]
        API[RESTful API]
        WH[Webhooks]
    end

    subgraph "Core Layer"
        Router[MCP Router]
        Auth[Authentication Module]
        NLP[Natural Language Parser]
        Memory[Memory Module]
        Queue[Task Queue]
    end

    subgraph "Integration Layer"
        Calendar[Google Calendar Integration]
        Docs[Google Docs Integration]
    end

    subgraph "Model Layer"
        ModelRouter[AI Model Router]
        GPT[GPT-4o Adapter]
        Claude[Claude Adapter]
        Gemini[Gemini Adapter]
    end

    subgraph "Infrastructure Layer"
        DB[(Database)]
        Cache[(Cache)]
        Scheduler[Cron Scheduler]
    end

    %% Core connections
    CLI --> Router
    API --> Router
    WH --> Router
    Router --> Auth
    Router --> NLP
    Router --> Calendar
    Router --> Docs
    Router --> Memory
    Router --> Queue
    NLP --> ModelRouter
    ModelRouter --> GPT
    ModelRouter --> Claude
    ModelRouter --> Gemini

快速开始

先决条件

• Node.js（v18或更高版本）
• npm或纱线
• MongoDB（本地开发可选）
• Redis（本地开发可选）

安装

1. 克隆存储库：

git clone https://github.com/yourusername/google-calendar-mcp-server.git
cd google-calendar-mcp-server

1. 安装依赖项：

npm install

1. 设置环境变量：

cp .env.example .env

编辑 .env 使用您的特定设置创建文件。

1. 构建项目：

npm run build

1. 启动服务器：

npm start

发展：

npm run dev

OAuth设置

1. 转到 谷歌云控制台
2. 创建新项目
3. 启用Google日历API和Google文档API
4. 设置OAuth同意屏幕
5. 创建OAuth 2.0凭据
6. 将凭据添加到您的 .env 文件

技术栈

• 运行时：使用TypeScript的Node.js
• 框架：Express.js
• 数据库：MongoDB
• 缓存：Redis
• 队列：公牛
• LLM框架：LangChain.js
• 认证：OAuth2.0
• 容器化：Docker和Docker Compose

有关技术选择的更多详细信息，请参阅 技术栈 文档。

发展路线图

• \[x\] 架构文档
• \[x\] 初始项目设置
• \[\]核心模块实现
• \[\]Google API集成
• \[\]型号适配器
• \[\]客户端接口
• \[\]调度程序实现
• \[\]测试和安全审查
• \[\]部署指南

贡献

欢迎投稿！请阅读我们的 贡献指南 有关我们的行为准则和提交pull请求流程的详细信息。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。