hudy

通过 HuDy MCP 计算韩国公共假期和工作日。查询假期、计算工作日、添加/减去工作日以及管理自定义假期。

# HuDy - Korean Holiday & Business Day Skill

Use the HuDy MCP server to query Korean public holidays, calculate business days, and manage custom holidays directly from your AI agent.

## Setup

### 1. Get an API Key

Sign up at [hudy.co.kr](https://www.hudy.co.kr) and create an API key from the dashboard.

### 2. Connect MCP

**Claude Code:**

```bash
claude mcp add --transport http hudy https://www.hudy.co.kr/api/mcp -H "x-api-key: YOUR_API_KEY"
```

**Claude Desktop / Cursor:**

```json
{
  "mcpServers": {
    "hudy": {
      "url": "https://www.hudy.co.kr/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

---

## Available Tools

### `get_holidays` (Free)

Query Korean public holidays by year or date range.

```text
"2026년 공휴일 알려줘"
"2026-03-01부터 2026-06-30까지 공휴일 조회해줘"
```

### `count_business_days` (Pro)

Count business days between two dates, excluding weekends and public holidays.

```text
"2026-03-01부터 2026-03-31까지 영업일 며칠이야?"
"이번 달 영업일 수 알려줘"
```

### `add_business_days` (Pro)

Calculate the date N business days after a given date.

```text
"2026-03-01에서 10영업일 후 날짜 알려줘"
"오늘부터 5영업일 뒤는 언제야?"
```

### `subtract_business_days` (Pro)

Calculate the date N business days before a given date.

```text
"2026-03-31에서 5영업일 전 날짜 알려줘"
```

### `check_business_day` (Pro)

Check if a specific date is a business day.

```text
"2026-03-01이 영업일이야?"
"오늘 영업일인지 확인해줘"
```

### Custom Holiday Management (Pro)

Manage user-defined holidays that are included in all business day calculations.

| Tool | Description |
| --- | --- |
| `list_custom_holidays` | List all custom holidays |
| `create_custom_holiday` | Register a new custom holiday |
| `update_custom_holiday` | Update an existing custom holiday |
| `delete_custom_holiday` | Delete a custom holiday |

```text
"회사 창립기념일 2026-05-15로 등록해줘"
"커스텀 공휴일 목록 보여줘"
```

---

## Plans

| Feature | Free | Pro ($3/mo) |
| --- | :---: | :---: |
| Public holiday lookup | ✅ | ✅ |
| Monthly API calls | 100 | 5,000 |
| Business day APIs | ❌ | ✅ |
| Custom holidays | ❌ | ✅ |
| Calendar sync (iCal) | ❌ | ✅ |

---

## Notes

- All dates use `YYYY-MM-DD` format.
- Holiday data is sourced from the Korean government open data portal (data.go.kr).
- Custom holidays are per-user and automatically included in business day calculations.
- Calendar sync provides an iCal URL for Google Calendar, Apple Calendar, and Outlook.

---

## 中文说明

# HuDy - 韩国假期与工作日技能

使用 HuDy MCP 服务器直接从 AI 代理查询韩国公共假期、计算工作日并管理自定义假期。

## 设置

### 1. 获取 API 密钥

在 [hudy.co.kr](https://www.hudy.co.kr) 注册并从控制面板创建 API 密钥。

### 2. 连接 MCP

**Claude Code：**

```bash
claude mcp add --transport http hudy https://www.hudy.co.kr/api/mcp -H "x-api-key: YOUR_API_KEY"
```

**Claude Desktop / Cursor：**

```json
{
  "mcpServers": {
    "hudy": {
      "url": "https://www.hudy.co.kr/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

---

## 可用工具

### `get_holidays`（免费）

按年份或日期范围查询韩国公共假期。

```text
"2026년 공휴일 알려줘"
"2026-03-01부터 2026-06-30까지 공휴일 조회해줘"
```

### `count_business_days`（Pro）

计算两个日期之间的工作日数，不包括周末和公共假期。

```text
"2026-03-01부터 2026-03-31까지 영업일 며칠이야?"
"이번 달 영업일 수 알려줘"
```

### `add_business_days`（Pro）

计算给定日期之后 N 个工作日的日期。

```text
"2026-03-01에서 10영업일 후 날짜 알려줘"
"오늘부터 5영업일 뒤는 언제야?"
```

### `subtract_business_days`（Pro）

计算给定日期之前 N 个工作日的日期。

```text
"2026-03-31에서 5영업일 전 날짜 알려줘"
```

### `check_business_day`（Pro）

检查特定日期是否为工作日。

```text
"2026-03-01이 영업일이야?"
"오늘 영업일인지 확인해줘"
```

### 自定义假期管理（Pro）

管理用户定义的假期，这些假期会包含在所有工作日计算中。

| 工具 | 说明 |
| --- | --- |
| `list_custom_holidays` | 列出所有自定义假期 |
| `create_custom_holiday` | 注册新的自定义假期 |
| `update_custom_holiday` | 更新现有自定义假期 |
| `delete_custom_holiday` | 删除自定义假期 |

```text
"회사 창립기념일 2026-05-15로 등록해줘"
"커스텀 공휴일 목록 보여줘"
```

---

## 套餐

| 功能 | 免费 | Pro ($3/月) |
| --- | :---: | :---: |
| 公共假期查询 | ✅ | ✅ |
| 每月 API 调用 | 100 | 5,000 |
| 工作日 API | ❌ | ✅ |
| 自定义假期 | ❌ | ✅ |
| 日历同步 (iCal) | ❌ | ✅ |

---

## 说明

- 所有日期均使用 `YYYY-MM-DD` 格式。
- 假期数据来源于韩国政府公开数据门户 (data.go.kr)。
- 自定义假期按用户独立设置，并自动包含在工作日计算中。
- 日历同步提供可用于 Google 日历、Apple 日历和 Outlook 的 iCal URL。