> 完整文档索引见 [llms.txt](https://docs.wanduanapi.com/llms.txt)。本站每个文档页均提供 Markdown 镜像；当前页面的 Markdown 版本见 [此处](https://docs.wanduanapi.com/products/china-calendar/mcp/quickstart.md)。

# MCP 快速开始

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

## 连接

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

```json
{
  "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` 语义一致，处理方式见[错误说明](../../../problems/index.md)；
- 年度安排未发布**不是错误**：工具返回正常的 `UNKNOWN` 业务结果，与 REST 行为一致。

## 后续步骤

→ [数据范围与可信度](../data-and-coverage.md)：了解 `UNKNOWN` 的产生条件与数据边界

→ [REST 参考](../rest/reference.md)：对照 REST 侧的参数与枚举