JinDaGe - calendar-mcp MCP Details

article

README

🚀 谷歌日历自动授权MCP服务器

这是一个用于自动化管理Google日历的MCP（机器学习控制协议）服务器，支持创建、更新、删除和查询日历事件等功能。该服务器集成了自动授权功能，简化了与Google Calendar API的交互流程。

🚀 快速开始

本服务器是用于自动化管理Google日历的MCP服务器，集成自动授权功能，简化与Google Calendar API的交互，支持日历事件的创建、更新、删除和查询等操作。

✨ 主要特性

自动化授权：用户通过简单的身份验证即可获得长期访问令牌，无需手动处理OAuth流程。
高可用性：采用高效的API设计和可靠的网络通信机制，确保服务稳定运行。
可扩展性：支持多线程处理，能够同时处理多个用户的日历请求。

📦 安装指南

安装依赖

确保系统已安装Python 3.6或更高版本。

安装必要的Python库：

pip install google-api-python-client oauth2client flask

配置步骤

下载项目代码并解压到指定目录。
配置环境变量：
- 设置GC_CREDENTIALS为包含OAuth凭证文件的路径。
- 设置GC_PROJECT_ID为目标项目的Google Cloud项目ID。

💻 使用示例

基础用法

# 创建新事件
curl -X POST \
     http://localhost:5000/api/events \
     -H "Content-Type: application/json" \
     -d '{"summary":"项目会议","start_time":"2024-05-16T10:00:00","end_time":"2024-05-16T11:30:00"}'

# 查询特定事件
curl -X GET \
     http://localhost:5000/api/events/abc123xyz456

高级用法

# 创建事件，支持通过JSON格式传递详细信息，包括标题、时间、地点等
{
    "summary": "会议",
    "start_time": "2024-05-15T14:00:00",
    "end_time": "2024-05-15T16:00:00"
}

📚 详细文档

功能模块

事件管理

创建事件：支持通过JSON格式传递详细信息，包括标题、时间、地点等。
更新事件：通过事件ID指定要修改的条目，并提供新的详细信息。
删除事件：使用事件ID直接从日历中移除特定条目。

日历同步

批量导入：支持一次性导入多个事件，提升数据迁移效率。
增量更新：仅同步变更的部分，减少网络传输量和服务器负载。

安全机制

凭证加密：所有OAuth凭证均经过AES加密处理，确保存储安全。
访问控制：基于角色的权限管理，防止未授权操作。
审计日志：记录所有API调用历史，便于后续追踪和分析。

项目文档

详细接口定义请参考API文档。
示例代码和使用教程可访问Wiki页面。

🔧 技术细节

本服务器采用高效的API设计和可靠的网络通信机制，支持多线程处理，能同时处理多个用户的日历请求。所有OAuth凭证均经过AES加密处理，采用基于角色的权限管理防止未授权操作，并记录所有API调用历史便于追踪和分析。

🤝 贡献与支持

欢迎提交Pull Request或报告问题。如需商业支持，请联系项目维护者。

感谢您选择我们的Google日历自动授权MCP服务器，期待您的反馈和建议！

calendar-mcp