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
• 模型上下文协议