Taiwan Holiday MCP Server

# 開發說明

## 🛠️ 開發說明

此文件提供 Taiwan Holiday MCP Server 的開發環境設定和相關說明。

## 🛠️ 開發環境設定

### 系統需求

- Node.js ≥ 18.0.0
- npm ≥ 8.0.0

### 安裝與建置

```bash
# 複製專案
git clone https://github.com/lis186/taiwan-holiday-mcp.git
cd taiwan-holiday-mcp

# 安裝相依套件
npm install

# 建置專案
npm run build

# 執行測試
npm test

# 啟動伺服器
npm start
```

## 🔧 開發工具

### 可用的 npm 腳本

```bash
npm run clean          # 清理建置檔案
npm run build          # 建置專案
npm run build:watch    # 監控模式建置
npm run test           # 執行測試
npm run test:watch     # 監控模式測試
npm run test:coverage  # 測試覆蓋率報告
npm run lint           # 程式碼檢查
npm run lint:fix       # 自動修正程式碼風格
npm run package:test   # 測試打包
npm run package:local  # 本地打包
```

## 🔗 MCP 客戶端整合

### Claude Desktop 開發設定

在 Claude Desktop 設定檔中使用本地路徑：

```json
{
  "mcpServers": {
    "taiwan-holiday": {
      "command": "npx",
      "args": ["taiwan-holiday-mcp"]
    }
  }
}
```

**開發環境設定（使用本地路徑）：**

```json
{
  "mcpServers": {
    "taiwan-holiday": {
      "command": "node",
      "args": ["/完整路徑/taiwan-holiday-mcp/dist/index.js"]
    }
  }
}
```

### 測試連線

```bash
# 確認伺服器可以正常啟動
node dist/index.js

# 應該會看到 MCP 伺服器啟動訊息
```

## 📝 開發注意事項

1. **版本管理**: 遵循語意化版本規範
2. **測試覆蓋**: 維持高測試覆蓋率（目前 77.84%）
3. **程式碼品質**: 使用 ESLint 和 TypeScript 確保程式碼品質
4. **文件同步**: 確保 README.md 和 API 文件保持同步

## 🚀 發布流程

發布新版本的步驟：

1. 更新版本號碼 (`npm version patch/minor/major`)
2. 更新 CHANGELOG.md 記錄變更
3. 執行完整測試 (`npm test`)
4. 建置專案 (`npm run build`)
5. 發布到 npm (`npm publish`)

## 📞 聯絡資訊

如有開發相關問題，請聯絡：
- 維護者: Justin Lee
- 專案: https://github.com/lis186/taiwan-holiday-mcp