インストールガイド

Hatago MCP Hubは複数の方法でインストールできます。プロジェクトの要件に応じて最適な方法を選択してください。

インストール方法

npx（推奨）

インストール不要で即座に使用開始。常に最新版を利用。

グローバルインストール

システム全体で利用可能。CLIコマンドとして使用。

プロジェクト依存

プロジェクトごとに管理。バージョン固定が可能。

Docker

完全に分離された環境。チーム開発に最適。

npx（推奨）

インストール不要で、常に最新版を使用します：

# 設定の初期化
npx @himorishige/hatago-mcp-hub init

# サーバーの起動
npx @himorishige/hatago-mcp-hub serve --stdio --config ./hatago.config.json

メリット

• 🚀 インストール不要
• ✨ 常に最新版
• 💾 ディスク容量を節約
• 🔄 キャッシュ管理自動

グローバルインストール

システム全体で使用する場合：

1. パッケージをインストール

   # npm
   npm install -g @himorishige/hatago-mcp-hub
   
   # pnpm
   pnpm add -g @himorishige/hatago-mcp-hub
   
   # yarn
   yarn global add @himorishige/hatago-mcp-hub

2. インストール確認

   hatago --version

3. 設定を初期化

   hatago init

4. サーバーを起動

   hatago serve

プロジェクト依存として

特定のプロジェクトに組み込む場合：

1. プロジェクトに追加

   # npm
   npm install @himorishige/hatago-mcp-hub
   
   # pnpm
   pnpm add @himorishige/hatago-mcp-hub
   
   # yarn
   yarn add @himorishige/hatago-mcp-hub

2. package.jsonにスクリプト追加

   {
     "scripts": {
       "mcp": "hatago serve",
       "mcp:init": "hatago init",
       "mcp:dev": "hatago serve --http --verbose"
     }
   }

3. スクリプト経由で実行

   npm run mcp:init  # 初期化
   npm run mcp       # 起動

Dockerを使用

完全に分離された環境で実行：

# Dockerfile
FROM node:20-alpine

WORKDIR /app

# Hatagoをインストール
RUN npm install -g @himorishige/hatago-mcp-hub

# 設定ファイルをコピー
COPY hatago.config.json .

# STDIOモードで起動
CMD ["hatago", "serve", "--stdio"]

Docker Composeの例：

docker-compose.yml

version: '3.8'

services:
  hatago:
    build: .
    volumes:
      - ./hatago.config.json:/app/hatago.config.json
      - ./workspace:/workspace
    environment:
      - GITHUB_TOKEN=${GITHUB_TOKEN}
      - API_KEY=${API_KEY}

環境別設定

Claude Code

.mcp.json を作成：

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

Codex CLI

~/.codex/config.toml に追加：

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

Cursor / Windsurf

プロジェクトの .cursor/mcp.json または .windsurf/mcp.json に設定：

{
  "mcpServers": {
    "hatago": {
      "command": "hatago",
      "args": ["serve", "--stdio"]
    }
  }
}

システム要件

必須要件

• Node.js: 20.0.0以上
• npm: 9.0.0以上（またはpnpm 8.0.0以上）
• OS: macOS、Linux、Windows（WSL推奨）

推奨環境

• メモリ: 512MB以上の空きメモリ
• ディスク: 100MB以上の空き容量
• ネットワーク: リモートMCPサーバー使用時はインターネット接続

バージョン管理

最新版へのアップデート

# グローバルインストールの場合
npm update -g @himorishige/hatago-mcp-hub

# プロジェクト依存の場合
npm update @himorishige/hatago-mcp-hub

# npxの場合（キャッシュクリア）
npx clear-npx-cache

特定バージョンの使用

# 特定バージョンをインストール
npm install @himorishige/[email protected]

# npxで特定バージョンを使用
npx @himorishige/[email protected] serve

アンインストール

グローバルインストールの削除

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

プロジェクト依存の削除

npm uninstall @himorishige/hatago-mcp-hub

npxキャッシュのクリア

npx clear-npx-cache
# または
rm -rf ~/.npm/_npx

トラブルシューティング

パーミッションエラー

グローバルインストール時にエラーが出る場合：

# npmの場合
npm install -g @himorishige/hatago-mcp-hub --unsafe-perm

# またはnpmのプレフィックスを変更
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

バージョンの確認

# インストール済みバージョン
hatago --version

# 最新版の確認
npm view @himorishige/hatago-mcp-hub version

# 利用可能なすべてのバージョン
npm view @himorishige/hatago-mcp-hub versions

次のステップ

インストールが完了したら、以下のガイドを参照してください：

• クイックスタート - 5分で始める
• 設定リファレンス - 詳細な設定方法
• CLIリファレンス - 利用可能なコマンド一覧