MCP 快速开始

如果调用方是 AI Agent 或自动化工作流，可以将节假日查询作为 MCP 工具接入。

连接

在 MCP 客户端中添加以下服务器：

{
  "mcpServers": {
    "china-calendar": {
      "url": "https://api.wanduanapi.com/v1/china-calendar/mcp"
    }
  }
}

可用工具

连接后可发现 4 个只读工具：

工具名	对应 REST operationCode	用途
china-calendar-get-date-status	chinaCalendar.getDateStatus	查询单日状态
china-calendar-get-date-range-status	chinaCalendar.getDateRangeStatus	查询区间逐日状态
china-calendar-calculate-workdays	chinaCalendar.calculateWorkdays	统计工作日数量
china-calendar-get-next-holiday	chinaCalendar.getNextHoliday	查询下一节假日

各工具的输入字段以 tools/list 返回的 schema 为准；日期均为 ISO 8601 yyyy-MM-dd。

验证连接

连接成功后，可以向 Agent 提出节假日问题进行验证：

2026 年国庆节是星期几？休息几天？

错误与未知安排

• 工具执行失败时返回 isError=true，文本格式为 CODE: 详细信息，CODE 与 REST 的错误 code 语义一致，处理方式见错误说明；
• 年度安排未发布不是错误：工具返回正常的 UNKNOWN 业务结果，与 REST 行为一致。

后续步骤

→ 数据范围与可信度：了解 UNKNOWN 的产生条件与数据边界

→ REST 参考：对照 REST 侧的参数与枚举