Hko MCP

🚀 hko_mcp

👋 このプロジェクトは現在積極的に開発されており、PRの投稿を歓迎します🙏。

hko_mcp はルイスの個人（「ペット」）プロジェクトで、学習練習と技術試験台として機能することを目的としています。このプロジェクトは、香港天文台 (HKO) および場合によっては他のMCP（カスタムまたはサードパーティサービス）API との統合に焦点を当てています。この計画は、最新の TypeScript ツールとテスト手法を中心にした実践的な探索として行われます。

✨ 主な機能

このプロジェクトは、香港天文台 (HKO) や他のMCP API との統合を目指し、最新の TypeScript ツールとテスト手法を活用した学習と技術試験台として機能します。

📦 インストール

インストール手順

# 1. このリポジトリをクローンする
$ git clone https://github.com/louiscklaw/hko-mcp.git

# 2. 環境を設定する
$ nvm use 22
$ node -v
# v22.14.0

# 3. プロジェクトをビルド / テストする
$ npm i -D
$ npm run build
$ npm run test

# 4. 以下の内容をあなたの 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 を例に説明します。

📚 ドキュメント

利用可能なスクリプト

• clean - カバレッジデータ、キャッシュ、トランスパイルされたファイルを削除します。
• prebuild - ビルド前にソースファイルとテストをコードチェックします。
• build - TypeScript を ES6 にトランスパイルします。
• build:watch - ソースファイルを自動的にトランスパイルするためのインタラクティブな監視モードです。
• lint - ソースファイルとテストをチェックします。
• prettier - ファイルを整形します。
• test - テストを実行します。
• test:watch - テストを自動的に再実行するためのインタラクティブな監視モードです。
• test:coverage - テストを実行し、テストカバレッジを出力します。

ディレクトリ構成

• documentation：要件や規格文書を保存します。
• src：ソースコードが格納されています。
• scripts：ツールスクリプトがあります。
• project：プロジェクト関連の設定が含まれています。
• README.md：プロジェクトの説明です。

🔧 技術詳細

技術スタック

以下のツールが含まれ、設定されています。

• TypeScript 5.7
• ESM
• ESLint いくつかの初期ルール推奨事項付き
• Vitest 高速な単体テストとコードカバレッジのため
• Node.js 型定義
• Prettier 一貫したコードスタイルを強制するため
• NPM スクリプト 一般的な操作のため
• EditorConfig 一貫したコーディングスタイルのため
• Volta による再現可能なビルド環境
• GitHub Actions のサンプル設定gh-actions
• 簡単な TypeScript コードと単体テストのサンプル

謝辞 / 参考

• node-typescript-boilerplate

進捗/TODO