日历管理服务

一个本地MCP服务器,连接Claude Desktop和Google Calendar,用于管理日历事件、获取事件详情、计算旅行时间等功能。

  • by Tekuor
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Tekuor/mcp-calendar

使用说明

MCP 日历服务器

当地的 模型上下文协议(MCP) 连接的服务器 Claude 桌面版 致你的 谷歌日历。

这让克劳德能够本地管理日历事件、查看日程安排,甚至计算会议之间的出行时间。


特点/功能

  • 管理活动 — 添加、更新、删除或查看Google日历事件
  • 获取活动详情 — 获取特定事件的详细信息
  • 获取坐标 — 使用(某种方法或工具)获取给定地点的坐标 OpenRouteService(可译为“开放路线服务”)
  • 旅行预估费用 — 计算两点之间的距离和时间
  • 本地运行 — 数据不会离开您的电脑

它是如何工作的

Claude Desktop 支持 MCP(模型上下文协议)以与本地或远程工具进行交互。
这个项目实现了MCP服务器在 Node.js 与克劳德进行交流的(系统/设备/人) stdio。


已实施的工具

工具 描述
get_events 列出日期范围内的Google日历事件
get_event 获取特定事件的详细信息
add_event 添加一个新事件
update_event 更新现有事件
delete_event 删除一个事件
get_coordinates 获取某地的坐标
get_distance_and_time 获取两个坐标点之间的距离和旅行时间

设置

1. 克隆仓库

git clone https://github.com/username/mcp-calendar.git
cd mcp-calendar

2. 安装依赖项

npm install

3. 创建一个 .env 文件

GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=your_google_redirect_uri
GOOGLE_REFRESH_TOKEN=your_google_refresh_token
OPENROUTESERVICE_API_KEY=your_openrouteservice_api_key

4. 运行MCP服务器

npm run build
npm start

5. 连接到Claude桌面版

打开Claude桌面版 进入设置 → 开发者 → 本地MCP服务器 添加一个新的本地服务器配置,例如:

{
  "command": "node",
  "args": ["C:\\path\\to\\build\\index.js"],
  "env": {}
}

重启Claude,它应该会自动检测并连接到您的MCP服务器。

技术栈

Node.js + TypeScript 谷歌日历API OpenRouteService API Claude MCP SDK(注:这里的“MCP”可能代表某个特定的模块、平台或框架,但根据上下文无法确定具体含义,因此直接保留原样翻译。)