MCP Client → AI CLI Hub → External CLI Commands
   │             │              │
   │             │              ├─ qwen -p "prompt"
   │             │              ├─ gemini -p "prompt" 
   │             │              └─ opencode -p "prompt"
   │             │
   │             ├─ OAuth Manager (環境変数経由)
   │             ├─ Command Builder
   │             └─ Error Handling

対応AI エンジン

エンジン	機能	認証方式
Qwen	コード生成、チャット、ファイル分析	OAuth 2.0 + API Key
Gemini	高度推論、文書分析、グラウンディング	OAuth 2.0 + API Key
OpenCode	マルチプロバイダー統合、フォールバック	OAuth 2.0

🚀 セットアップ

NPXで即座に使用（推奨）

# 初期化 (設定ファイルとディレクトリ作成)
npx ai-cli-hub init

# MCPサーバー起動
npx ai-cli-hub start

# デモ環境セットアップ
npx ai-cli-hub demo

1. ローカルインストール

# グローバルインストール
npm install -g ai-cli-hub

# または開発用ローカルインストール
git clone https://github.com/your-username/ai-cli-hub.git
cd ai-cli-hub
npm install
npm run build

2. AI CLIツールの準備

各AIエンジンのCLIツールをインストール：

# Qwen CLI
pip install qwen-cli

# Gemini CLI  
pip install google-generativeai-cli

# OpenCode CLI
npm install -g opencode-cli

3. 認証設定

# OAuth認証
npm run auth:setup

# またはAPI Keyを設定
export QWEN_API_KEY="your-api-key"
export GEMINI_API_KEY="your-api-key"

4. MCP サーバー起動

# 開発モード
npm run dev

# プロダクション
npm run start

🔧 使用方法

Claude Code での設定

claude_desktop_config.json に追加：

NPX使用の場合（推奨）

{
  "mcpServers": {
    "ai-cli-hub": {
      "command": "npx",
      "args": ["ai-cli-hub", "start"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

ローカルインストールの場合

{
  "mcpServers": {
    "ai-cli-hub": {
      "command": "ai-cli-hub",
      "args": ["start"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

開発環境の場合

{
  "mcpServers": {
    "ai-cli-hub": {
      "command": "node",
      "args": ["/path/to/ai-cli-hub/dist/index.js"],
      "env": {
        "NODE_ENV": "development"
      }
    }
  }
}

利用可能なツール

Qwen ツール

qwen_chat: AIチャット機能
qwen_analyze_file: ファイル分析
qwen_change_file: ファイル変更
qwen_generate_code: コード生成

Gemini ツール

gemini_chat: 高度推論チャット
gemini_analyze_document: 文書分析
gemini_code_review: コードレビュー
gemini_grounding_search: グラウンディング検索

OpenCode ツール

opencode_chat: マルチプロバイダーチャット
opencode_generate_code: コード生成
opencode_explain_code: コード説明

🧪 テスト

モック環境でのテスト

# モックAIコマンドの作成
demo/mock-ai-commands.sh

# モック環境のセットアップ
source demo/setup-mock-env.sh

# テスト実行
npm run test

外部コマンド統合テスト

# 単体テスト
node test/external-command.test.js

# 統合テスト
node test/mcp-integration.test.js

⚙️ 設定

ai-cli-hub.config.json

{
  "engines": {
    "qwen": {
      "enabled": true,
      "useOAuth": true,
      "model": "qwen3-coder-plus",
      "timeout": 30000
    },
    "gemini": {
      "enabled": true,
      "useOAuth": true,
      "model": "gemini-2.5-pro",
      "grounding": true
    },
    "opencode": {
      "enabled": true,
      "useOAuth": true,
      "provider": "anthropic"
    }
  },
  "features": {
    "fileOperations": true,
    "gitIntegration": true
  },
  "server": {
    "logLevel": "info",
    "timeout": 120000
  }
}

🔐 セキュリティ

OAuth 2.0 フロー完全対応
認証トークンの安全な管理
環境変数経由の認証情報渡し
タイムアウト・エラーハンドリング

📊 統合実績

調査・統合結果

✅ 既存Python実装の調査完了
✅ 外部コマンド統合パターン採用
✅ OAuth認証システム統合
✅ 完全動作確認完了

アーキテクチャ改善

Before: TODO実装（未動作）
After: 外部コマンド統合（完全動作）

🤝 コントリビューション

Fork the repository
Create feature branch: git checkout -b feature/amazing-feature
Commit changes: git commit -am 'Add amazing feature'
Push to branch: git push origin feature/amazing-feature
Open Pull Request

📝 ライセンス

MIT License - 詳細は LICENSE ファイルを参照

🔗 関連リンク

Keywords

mcp

model-context-protocol

gemini

qwen

opencode

FAQs

What is ai-cli-hub?

Is ai-cli-hub well maintained?

Package last updated on 01 Sep 2025

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

ai-cli-hub

AI CLI Hub - Unified MCP Server

🌟 特徴

🏗️ アーキテクチャ

外部コマンド統合アプローチ