🚀 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：项目说明。