Hko MCP

🚀 hko_mcp

hko_mcp 是路易斯的個人（“寵物”）項目，主要用於學習練習與技術試驗。該項目聚焦於與香港天文臺（HKO）以及可能的其他 MCP（自定義或第三方服務）API 進行集成。通過這個項目，可以深入探索現代 TypeScript 工具和測試實踐。目前該項目正在積極開發中，歡迎提交 PR 共同參與！

🚀 快速開始

克隆倉庫

$ git clone https://github.com/louiscklaw/hko-mcp.git

配置環境

$ nvm use 22
$ node -v
# v22.14.0

構建與測試項目

$ npm i -D
$ npm run build
$ npm run test

添加配置

將以下內容添加到您的 mcp 配置中（通常為 cline_mcp_settings.json）：

{
  "mcpServers": {
    ... # 在此行下添加以下內容 ...
    "hko-mcp": {
      "args": [
        "<clone_path>/hko-mcp/project/build/src/main.js"
      ],
    ... # 下面的行取決於您的 mcp 客戶端 ...
      "disabled": false,
      "timeout": 60,
      "command": "node",
      "transportType": "stdio"
    }
  }
}

以 Cline 為例，效果如下：

✨ 主要特性

• 專注於與香港天文臺（HKO）和可能的其他 MCP API 集成。
• 作為學習練習和技術試驗檯，探索現代 TypeScript 工具和測試實踐。

📦 安裝指南

按照上述“快速開始”部分的步驟進行操作，即可完成項目的克隆、環境配置、構建和測試。

💻 使用示例

基礎用法

按照“快速開始”中的步驟操作，即可完成項目的安裝和基本配置。

高級用法

可以根據項目需求，對 mcp 配置文件進行進一步的調整，以滿足不同的使用場景。

🔧 技術細節

技術棧

項目包含並配置了以下工具：

• TypeScript 5.7
• ESM
• ESLint 帶有一些初始規則推薦
• Vitest 用於快速單元測試和代碼覆蓋率
• Node.js 類型定義
• Prettier 以強制一致的代碼風格
• NPM 腳本 用於常見操作
• EditorConfig 用於一致的編碼風格
• 由於 Volta 提供了可重複構建環境
• GitHub Actions 的示例配置gh-actions
• 簡單的 TypeScript 代碼和單元測試示例

可用腳本

• clean - 刪除覆蓋率數據、緩存和轉譯文件。
• prebuild - 在構建之前對源文件和測試進行代碼檢查。
• build - 將 TypeScript 轉譯為 ES6。
• build:watch - 交互式監視模式以自動轉譯源文件。
• lint - 檢查源文件和測試。
• prettier - 格式化文件。
• test - 運行測試。
• test:watch - 交互式監視模式以自動重新運行測試。
• test:coverage - 運行測試並輸出測試覆蓋率。

📄 許可證

文檔中未提及許可證相關信息。

📚 參考資料

致謝 / 借鑑

• node-typescript-boilerplate

進度/待辦事項

目錄結構

• documentation：存儲需求和規範文檔。
• src：源代碼。
• scripts：工具腳本。
• project：項目相關配置。
• README.md：項目說明。