CLIリファレンス

Hatago MCP Hub は hatago コマンドとして提供されます。ここでは主なサブコマンドとオプションを説明します。

インストール/実行

# npx で直接実行（推奨）
npx @himorishige/hatago-mcp-hub --version

npm install -g @himorishige/hatago-mcp-hub

`hatago init`

設定ファイル（hatago.config.json）を作成します。

hatago init           # 対話的に作成

hatago init --mode stdio           # STDIO モード前提のテンプレート

hatago init --mode http            # HTTP モード前提のテンプレート

hatago init --config my-config.json          # 出力先を指定

-c, --config <path>: 出力先のパス（既定: ./hatago.config.json）
-f, --force : 既存ファイルを上書き
-m, --mode <stdio|http>: 統合モードの事前選択

`hatago serve`

Hatago Hub を起動します。

hatago serve                # 既定（STDIO）

hatago serve --stdio                # 明示的に STDIO

hatago serve --http                 # HTTP モード

hatago serve --verbose              # 詳細ログ

hatago serve --tags development,test                 # タグでサーバーを選別

--stdio / --http : 実行モードの選択（既定: STDIO）
-c, --config <path> : 設定ファイルのパス（STDIO では必須）
-h, --host <host> : HTTP のホスト（既定: 127.0.0.1）
-p, --port <port> : HTTP のポート（既定: 3535）
--tags <a,b,c> : タグで有効化するサーバーを絞り込み
--verbose / --quiet : ログ出力の詳細度

設定ファイルの自動リロード（v0.0.14以降）

v0.0.14からは、パフォーマンス向上のため組み込みの設定監視機能を削除しました。設定の自動リロードが必要な場合は、以下の外部ツールを使用してください：

nodemonを使用

npx nodemon --exec "hatago serve" --watch hatago.config.json

PM2を使用

pm2 start "hatago serve" --watch hatago.config.json

タグ付きの例

npx nodemon --exec "hatago serve --tags dev" --watch hatago.config.json

Claude Code / Gemini CLI
Codex CLI

{
  "mcpServers": {
    "hatago": {
      "command": "npx",
      "args": ["@himorishige/hatago-mcp-hub", "serve", "--stdio", "--config", "./hatago.config.json"]
    }
  }
}

[mcp_servers.hatago]
command = "npx"
args = ["-y", "@himorishige/hatago-mcp-hub", "serve", "--stdio", "--config", "./hatago.config.json"]

環境変数のセットアップ

# 環境変数の設定
export GITHUB_TOKEN="your-github-token"
export OPENAI_API_KEY="your-openai-key"
export API_TOKEN="your-api-token"

# または.envファイルを使用

echo "GITHUB_TOKEN=your-github-token" >> .env
echo "OPENAI_API_KEY=your-openai-key" >> .env
echo "API_TOKEN=your-api-token" >> .env

Docker 例

# Dockerイメージのビルド
docker build -t hatago .

# コンテナの起動

docker run -it \
-v $(pwd)/hatago-config.json:/app/hatago-config.json \
  -e GITHUB_TOKEN=$GITHUB_TOKEN \
hatago

# docker-composeを使用

docker-compose up

デバッグ

# デバッグモードで起動
hatago serve --verbose

# ログレベルを設定

export LOG_LEVEL=debug
hatago serve

# 特定のサーバーのみデバッグ

hatago serve --tags debug --verbose