Chronary

@chronary/mcp

适用于 Chronary 的 MCP 服务——为 AI 助手提供日历工具。

将 50 个日历工具（管理 Agent、日历和事件，请求人工完成 Google/Microsoft 设置，查找会议时间，运行日程安排提案，配置可用时间规则，管理 Webhook、iCal 订阅、范围限定密钥、审计日志和使用情况）接入任何兼容 MCP 的客户端：Claude Desktop、Cursor、VS Code Copilot、Claude Code、Windsurf。

通过 Smithery 一键安装： npx -y @smithery/cli mcp add chronary/agent-calendar --client claude（将 --client 替换为 cursor、vscode、claude-code、windsurf 等）。

前提条件

1. Chronary 账户——在 chronary.ai 注册。
2. 从控制台获取 API 密钥（以 chr_sk_ 开头）。
3. 运行 MCP 客户端的机器上需安装 Node.js ≥ 18。

客户端配置

以下示例均使用 npx -y @chronary/mcp，按需下载并运行最新版本。无需安装。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

macOS / Linux：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": {
        "CHRONARY_API_KEY": "chr_sk_..."
      }
    }
  }
}

Windows（使用 cmd /c，因为 spawn 无法直接解析 npx.cmd）：

{
  "mcpServers": {
    "chronary": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": {
        "CHRONARY_API_KEY": "chr_sk_..."
      }
    }
  }
}

保存后重启 Claude Desktop。

Cursor

编辑 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（用户级）：

macOS / Linux：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windows：

{
  "mcpServers": {
    "chronary": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

VS Code Copilot

编辑 .vscode/mcp.json（工作区级），或运行 MCP: Open User Configuration 命令配置用户级设置。VS Code 使用不同的顶层键（servers），并且需要显式指定 type：

macOS / Linux：

{
  "servers": {
    "chronary": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windows：

{
  "servers": {
    "chronary": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Claude Code

编辑项目根目录下的 .mcp.json，或编辑 ~/.claude.json 进行用户级配置：

macOS / Linux：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windows：

{
  "mcpServers": {
    "chronary": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json（Windows 上为 %USERPROFILE%\.codeium\windsurf\mcp_config.json）：

macOS / Linux：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": ["-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windows：

{
  "mcpServers": {
    "chronary": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@chronary/mcp"],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

Windsurf 限制： Cascade 对所有 MCP 服务的工具总数设有 100 个的硬性上限，每个提示词最多可调用 20 次工具。Chronary 提供 50 个工具；如果同时使用多个服务，请考虑通过 --tools 筛选工具。

使用 --tools 减少上下文占用

公开全部 50 个工具会在每次请求中消耗大模型 Token。对于专注型工作流，只将需要的工具加入白名单：

{
  "mcpServers": {
    "chronary": {
      "command": "npx",
      "args": [
        "-y", "@chronary/mcp",
        "--tools", "list_events,find_meeting_time,create_event"
      ],
      "env": { "CHRONARY_API_KEY": "chr_sk_..." }
    }
  }
}

指向非生产 API

对于可自托管的 Chronary 实例，或针对本地 API 进行开发：

{
  "args": ["-y", "@chronary/mcp", "--base-url", "http://localhost:8787"]
}

提供的工具

工具	只读	破坏性
list_calendars, get_calendar	✓
create_calendar, update_calendar
delete_calendar		✓
list_events, get_event	✓
create_event, update_event, confirm_event
cancel_event, release_event		✓
list_agents, get_agent	✓
create_agent, update_agent
delete_agent		✓
get_availability, find_meeting_time	✓
get_calendar_context	✓
list_proposals, get_proposal	✓
create_proposal, respond_to_proposal, resolve_proposal
cancel_proposal		✓
get_availability_rules	✓
set_availability_rules
clear_availability_rules		✓
list_webhooks, get_webhook, list_webhook_deliveries	✓
create_webhook, update_webhook
delete_webhook		✓
list_ical_subscriptions, get_ical_subscription	✓
subscribe_ical, update_ical_subscription, sync_ical_subscription
delete_ical_subscription		✓
list_scoped_keys	✓
create_scoped_key
revoke_scoped_key		✓
get_audit_log	✓
accept_terms
get_usage	✓

工具注解（readOnlyHint、destructiveHint、idempotentHint）会提供给 MCP 客户端，以便宿主决定是否需要用户确认。

故障排除

Windows 上出现“spawn npx ENOENT”——使用上文所示的 cmd /c npx ... 形式。

出现“CHRONARY_API_KEY is required”——环境变量代码块必须嵌套在服务器条目下，而不是位于配置文件顶层。

没有显示工具——编辑配置后，重启 MCP 客户端。大多数客户端只会在启动时读取配置。

验证二进制文件能否在本地运行：

CHRONARY_API_KEY=test npx -y @chronary/mcp --help

链接

• Chronary 文档
• MCP 规范
• 报告问题

许可证

Apache-2.0