Ai Consultant MCP

🚀 AI Consultant MCP Server

このModel Context Protocol (MCP)サーバーは、AIエージェントがOpenRouterを通じて複数のAIモデルに相談できるようにします。インテリジェントなモデル自動選択、会話履歴、キャッシュ、そして堅牢なエラーハンドリング機能を備えています。

🚀 クイックスタート

npmからのインストール

npm install -g ai-consultant-mcp

前提条件

OpenRouterのAPIキーが必要です。OpenRouterで取得してください。

📦 インストール

オプション1: npmパッケージを使用する（推奨）

MCPクライアントの設定ファイルを編集します。

Claude Desktopの場合:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ai-consultant": {
      "command": "npx",
      "args": ["-y", "ai-consultant-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "your-openrouter-api-key"
      }
    }
  }
}

その他のMCPクライアントの場合: クライアントのドキュメントに従って設定し、コマンドとしてnpx -y ai-consultant-mcpを使用します。

オプション2: ローカルで実行する（開発用）

1. リポジトリをクローンします。

git clone https://github.com/filipkrayem/ai-consultant-mcp.git
cd ai-consultant-mcp

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

4. MCPクライアントを設定します。

{
  "mcpServers": {
    "ai-consultant": {
      "command": "node",
      "args": ["/absolute/path/to/ai-consultant-mcp/dist/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "your-openrouter-api-key"
      }
    }
  }
}

環境変数

• OPENROUTER_API_KEY (必須): あなたのOpenRouter APIキー
• VERBOSE_LOGGING (オプション): 詳細なログを有効にするにはtrueまたは1に設定します。デフォルト: false

📚 ドキュメント

利用可能なモデル

• gemini-2.5-pro: GoogleのGemini 2.5 Pro - 汎用タスクと簡単な質問
• gpt-5-codex: OpenAIのGPT-5 Codex - コーディングタスク、デバッグ、リファクタリング
• grok-code-fast-1: xAIのGrok Code Fast 1 - コードレビュー、複雑な推論、分析

✨ 主な機能

• 🤖 複数のAIモデル - 1つのインターフェースを通じてGPT、Gemini、Grokなどにアクセスできます。
• 🎯 スマートなモデル選択 - タスクに最適なモデルを自動的に選択します。
• 💬 会話履歴 - 複数の質問にまたがってコンテキストを維持します。
• ⚡ レスポンスキャッシュ - API呼び出しとコストを削減します。
• 🔄 自動リトライ - 一時的な障害をうまく処理します。
• 🛡️ サーキットブレーカー - 連鎖的な障害を防ぎます。
• 📊 トークントラッキング - 各相談の使用状況を監視します。

💻 使用例

設定が完了すると、AIアシスタントは以下のツールを使用できます。

• consult_ai - AIモデルに質問を投げる（自動選択または特定のモデルを指定）
• list_models - 利用可能なすべてのモデルとその機能を表示する

AIアシスタントにAIモデルに相談するように依頼するだけです。例えば:

• "この変更をGrokとCodexに相談して"
• "まずGrokにコードをレビューしてもらえ"

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

📄 ライセンス

MIT

🔗 リンク

• GitHubリポジトリ
• npmパッケージ
• OpenRouter
• Model Context Protocol