日历调度工具

MCP Scheduler是一个轻量级的MCP服务器,将Google Calendar API请求封装为MCP工具,包括客户端和LangGraph React Agent,用于调度、查看和管理日历事件。

  • by BDWiii
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 bdwiii/mcp-scheduler

使用说明

MCP调度器

MCP调度器 是一个轻量级的MCP(模型上下文协议)服务器,它封装 谷歌日历API 作为MCP工具的请求。
它包括一个客户端和一个LangGraph React Agent,可以推理这些工具来安排、查看和管理日历事件。

->此代理旨在使用任何自托管的MCP服务器。 它应该被用作更大架构中的简单子代理。


特性

  • MCP服务器 公开Google日历API作为工具
  • MCP客户端 用于与服务器交互
  • LangGraph反应代理 调度动作的推理
  • 易于运行和扩展

需求

  • Python 3.9+
  • Google日历API证书(OAuth 2.0)
  • 所需的Python依赖项(请参阅 requirements.txt)

安装

  1. 克隆存储库
git clone https://github.com/BDWiii/MCP-Scheduler.git
cd mcp-scheduler
  1. 安装依赖项
pip install -r requirements.txt
  1. 设置Google API凭据 关注谷歌 日历API设置指南 将凭据文件另存为项目根目录中的credentials.json

用法

使用以下方式运行项目:

python -m main

->注1 为配置文件提供服务器的绝对路径,以便其正常工作。

->注2 该系统使用Ollama在本地LLM上运行。

✅ 使用Olama

确保您已在本地安装并运行Ollama。然后,在config.yaml中,设置要使用的模型名称,例如“llama3”或“mistral”,就可以开始了。

🔁 使用不同的LLM 如果您没有使用Ollama,您可以在agents/mcp_agent.py中轻松修改LLM调用逻辑以适应您的环境

转到agents/mcp_agent.py,用您的首选模型或API(例如,OpenAI、Claude或vLLM)替换LLM客户端(目前使用ChatOllama设置)。

这将:

  • 启动MCP服务器
  • 连接MCP客户端
  • 启动LangGraph React Agent来处理调度任务

交互示例

运行后,代理可以执行以下操作:

  • 在Google日历中创建新事件
  • 列出即将举行的活动
  • 删除或更新事件