返回 MCP 目录
public公开dns本地运行

Scheduler-MCP

一个基于MCP协议的Google日历和任务管理服务,提供日程安排、任务创建等功能。

article

README

🚀 MCP 调度器

这是一个 MCP 服务器,为用户提供管理 Google 日历和任务的实用工具,助力高效安排日程与任务管理。

🚀 快速开始

📦 安装指南

  1. 依据 Model context protocol 的建议,安装 uv 来管理项目依赖项。
  2. 克隆仓库
    git clone https://github.com/JorgeVanco/Scheduler-MCP.git
    cd Scheduler-MCP
    
  3. 配置 Google API 凭证
    • 访问 Google Cloud Console
    • 创建一个全新的项目。
    • 启用 Google Calendar API 和 Google Tasks API。
    • 创建 OAuth 2.0 凭证,并下载 credentials.json 文件。
    • credentials.json 文件放置在项目的根目录下。
  4. 将 MCP 配置添加到模型配置文件中 在配置文件里添加如下 JSON 配置:
"mcpServers": {
    "Scheduler": {
        "command": "uv",
        "args": [
            "--directory",
            "C:\\Path\\to\\Scheduler-MCP",
            "run",
            "-m",
            "src.main"
        ]
    }
}

⚠️ 重要提示

请将 C:\\Path\\to\\Scheduler-MCP 替换为 Scheduler-MCP 文件夹的完整路径。此配置会使用 uv 在指定目录中运行 src.main 模块。

💻 使用示例

基础用法

配置完成之后,您的语言模型就能借助此 MCP 服务器与 Google Calendar 和 Google Tasks 展开交互。以下是一些示例命令:

  • "安排明天上午 10 点的会议"
  • "显示这周的事件"
  • "创建一个买杂货的任务"

🔧 技术细节

故障排除

Google 身份验证

首次启动模型的 MCP 服务器时,会弹出一个 Google 身份验证窗口,请求访问您的日历。访问令牌会存储在 token.json 中,以避免每次都需登录。

若遇到错误,可能是因为令牌已过期。要解决该问题,可从 Scheduler-MCP 文件夹中删除 token.json 文件。

💡 使用建议

即将推出自动管理身份验证令牌的工具,敬请期待。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端