Ai Consultant MCP

🚀 AI顧問MCP服務器

AI顧問MCP服務器是一個模型上下文協議（MCP）服務器，它允許AI代理通過OpenRouter與多個AI模型進行諮詢交互。該服務器具備智能模型自動選擇、對話歷史記錄、緩存和強大的錯誤處理等功能。

🚀 快速開始

從npm安裝

npm install -g ai-consultant-mcp

前提條件

你需要一個OpenRouter API密鑰。你可以在OpenRouter上獲取。

✨ 主要特性

• 🤖 多AI模型支持 - 通過一個接口訪問GPT、Gemini、Grok等多種模型。
• 🎯 智能模型選擇 - 自動為你的任務挑選最合適的模型。
• 💬 對話歷史記錄 - 在多個問題之間保持上下文連貫性。
• ⚡ 響應緩存 - 減少API調用次數和成本。
• 🔄 自動重試 - 優雅地處理臨時故障。
• 🛡️ 熔斷機制 - 防止級聯故障。
• 📊 令牌跟蹤 - 監控每次諮詢的使用情況。

📦 安裝指南

選項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：谷歌的Gemini 2.5 Pro - 適用於通用任務和快速問答。
• gpt-5-codex：OpenAI的GPT-5 Codex - 適用於編碼任務、調試和重構。
• grok-code-fast-1：xAI的Grok Code Fast 1 - 適用於代碼審查、複雜推理和分析。

💻 使用示例

基礎用法

配置完成後，你的AI助手可以使用以下工具：

• consult_ai - 向AI模型提問（自動選擇或指定模型）。
• list_models - 查看所有可用模型及其功能。 你只需讓你的AI助手與AI模型進行諮詢即可。例如：
• "讓Grok和Codex評估這個更改"
• "先讓Grok審查你的代碼"

🤝 貢獻

歡迎貢獻代碼！請隨時提交拉取請求。

📄 許可證

本項目採用MIT許可證。

🔗 鏈接

• GitHub倉庫
• npm包
• OpenRouter
• 模型上下文協議