Chronary MCP 是 Chronary 日历 API 的 MCP 服务器,旨在为 AI 助手提供日历相关工具。它向任何兼容 MCP 的客户端(如 Claude Desktop、Cursor、VS Code Copilot、Claude Code、Windsurf)提供 50 个日历工具,涵盖管理代理、日历和事件,请求人工 Google/Microsoft 设置,查找会议时间,运行日程提案,配置可用性规则,管理 webhook、iCal 订阅、作用域密钥、审计日志和用量。
使用方式:
- 前置条件:需要 Chronary 账户(在 chronary.ai 注册)、控制台生成的 API 密钥(以 chr_sk_ 开头),以及运行 MCP 客户端的机器上安装 Node.js ≥ 18。
- 一键安装:通过 Smithery 执行 npx -y @smithery/cli mcp add chronary/agent-calendar --client claude(可将 --client 替换为 cursor、vscode、claude-code、windsurf 等)。
- 手动配置:所有示例使用 npx -y @chronary/mcp,按需下载并运行最新版本,无需安装步骤。各客户端配置文件位置不同:Claude Desktop 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS)或 %APPDATA%\Claude\claude_desktop_config.json(Windows),Windows 需使用 cmd /c 形式;Cursor 编辑 .cursor/mcp.json(项目级)或 ~/.cursor/mcp.json(用户级);VS Code Copilot 编辑 .vscode/mcp.json(工作区)或运行 MCP: Open User Configuration 命令,使用顶层键 servers 并需要显式 type;Claude Code 编辑项目根目录的 .mcp.json 或用户级 ~/.claude.json;Windsurf 编辑 ~/.codeium/windsurf/mcp_config.json(Windows 为 %USERPROFILE%.codeium\windsurf\mcp_config.json)。保存后需重启 MCP 客户端。
- 减少上下文:暴露全部 50 个工具会在每次请求时消耗 LLM token,可通过 --tools 参数白名单筛选所需工具。
- 指向非生产 API:支持自托管 Chronary 实例或针对本地 API 开发。
- 工具注解:readOnlyHint、destructiveHint、idempotentHint 会暴露给 MCP 客户端,以便宿主决定是否需要用户确认。
适用场景:需要将日历管理、会议时间查找、日程提案、可用性规则配置等能力集成到 AI 助手工作流中的用户。
限制:Windsurf 的 Cascade 对所有 MCP 服务器总计工具数有 100 个硬上限,且每次提示最多 20 次工具调用;Chronary 暴露 50 个工具,若叠加多个服务器需考虑使用 --tools 过滤。其他限制暂未提供。