Ask MCP

询问MCP🤖

](https://badge.fury.io/js/ask-mcp)  

一个强大的模型上下文协议（MCP）服务器，通过OpenRouter提供对多个最先进的AI模型的无缝访问。非常适合与Cursor、Claude Desktop和其他MCP兼容客户端集成。

✨ 特性

• 🎯 5种高级AI模型：Grok、Gemini 2.5 Pro、Kimi、Qwen3编码员、GLM-4.5
• 💰 免费层支持：在可用时访问免费版本
• 🔐 OAuth身份验证：安全的OpenRouter集成
• 🚀 轻松设置：一个命令OAuth配置
• 🔌 MCP兼容：适用于Cursor、Claude Desktop等
• 📦 TypeScript：全型安全和现代发展

支持的型号

• 格罗克：高级推理和分析（x-ai/grok-4）
• 双子座2.5 Pro：谷歌最新的多模式人工智能（Google/gemini-2.5-pro）
• 基米：高效快速的响应（moonshotai/kimi-k2）
• Qwen 3编码器：专门用于编码任务（qwen/qwen3编码器）
• 一般线性模型：通用语言模型（z-ai/glm-4.5）

自由模型变体

该工具支持免费型号变体，以实现经济高效的使用：

• Kimi免费：moonshotai/kimi-k2：免费
• Qwen免费：qwen/qwen3编码器：免费
• GLM免费：z-ai/glm-4.5-空气：免费

当发生支付错误时，免费模型会自动用作回退，或者可以使用 free 参数。

安装

选项1:NPM包（推荐）

npm install -g ask-mcp

首次设置：安装后，您需要使用OpenRouter进行身份验证。您可以：

1. 设置API密钥： export OPENROUTER_API_KEY="your-key-here"
2. 或者使用OAuth设置（从源代码）： npm run setup 并在提示时按ENTER键

选项2：从源安装

1. 克隆并安装：

   git clone https://github.com/SerPepe/Ask-MCP
   cd ask-mcp
   npm install
   npm run build

1. 在MCP客户端中配置 （见下面的配置部分）

1. 首次设置：

当您首次使用MCP服务器时，它将自动提示您进行OAuth身份验证。您也可以手动运行安装程序：

   npm run setup

快速开始

选项1:NPM安装（推荐）

1. Install globally: npm install -g ask-mcp
2. Configure in your MCP client (Cursor/Claude Desktop)
3. First-time setup: When you first use the MCP server, it will automatically detect the missing API key and prompt you to authenticate with OpenRouter via OAuth. Simply press ENTER when prompted, and your browser will open automatically for secure authentication.
4. Start using the AI models!

选项2：使用OAuth设置从源代码（自动身份验证）

1. Clone the repository
2. Install dependencies: npm install
3. Run OAuth setup: npm run setup
4. Press ENTER when prompted (browser will auto-open for OpenRouter OAuth)
5. Complete authentication in browser
6. Test the server: npm test

选项3：手动设置API密钥

1. Clone the repository
2. Install dependencies: npm install
3. Build the project: npm run build
4. Set your OpenRouter API key: export OPENROUTER_API_KEY="your-key-here"
5. Test the server: npm test

配置

身份验证选项

Ask MCP工具支持两种身份验证方法：

选项1：API密钥验证（推荐）

1. 注册地址： OpenRouter 的
2. 从仪表板获取API密钥
3. 向您的帐户添加积分
4. 设置 OPENROUTER_API_KEY 环境变量

选项2:OAuth身份验证

1. 使用内置的OAuth流进行安全身份验证
2. 生成API密钥的授权URL和交换代码
3. 非常适合需要用户同意的应用程序

配置MCP客户端

用于游标IDE

选项A：使用NPM包（推荐）

{
  "mcpServers": {
    "ask-mcp": {
      "command": "ask-mcp"
    }
  }
}

选项B：使用本地构建

{
  "mcpServers": {
    "ask-mcp": {
      "command": "node",
      "args": ["/path/to/ask-mcp/dist/index.js"]
    }
  }
}

选项C：手动API密钥（可选） 如果您更喜欢手动设置API密钥，而不是使用OAuth：

{
  "mcpServers": {
    "ask-mcp": {
      "command": "ask-mcp",
      "env": {
        "OPENROUTER_API_KEY": "your-openrouter-api-key-here"
      }
    }
  }
}

适用于克劳德桌面

与上述相同的配置选项适用于Claude Desktop。

用法

配置后，您可以在MCP客户端中使用以下命令：

问Grok

ask-grok "What is the latest in AI development?"

问双子座

ask-gemini "Explain quantum computing in simple terms"

问Kimi

ask-kimi "Write a Python function to sort a list"

问Qwen

ask-qwen "Debug this JavaScript code: console.log('hello world')"

询问GLM

ask-glm "Translate this to Spanish: Hello, how are you?"

每种模式都有其独特的优势：

• 使用 格罗克 用于复杂的推理和分析
• 使用 双子座 用于多模式任务（文本+图像）
• 使用 基米 快速、高效的响应
• 使用 疾风之狼 用于编码和技术任务
• 使用 一般线性模型 用于一般语言任务

智能回退系统

该工具包括智能错误处理：

1. 自动回退：当发生支付/配额错误时，该工具会自动重试免费型号变体

1. 手动自由模式：使用 free: true 参数直接使用自由模型

1. 错误恢复：全面的错误消息有助于诊断问题

带系统提示

您还可以提供自定义系统提示：

ask-grok {
  "question": "What's the weather like?",
  "system_prompt": "You are a helpful weather assistant. Always ask for location if not provided."
}

使用免费模型

您可以明确地使用免费模型变体：

ask-kimi {
  "question": "What is machine learning?",
  "free": true
}

使用示例

基本用法

{
  "name": "ask-grok",
  "arguments": {
    "question": "Explain quantum computing"
  }
}

使用自定义系统提示

{
  "name": "ask-gemini",
  "arguments": {
    "question": "Write a Python function to sort a list",
    "system_prompt": "You are a senior Python developer. Provide clean, well-documented code."
  }
}

使用免费模型

{
  "name": "ask-kimi",
  "arguments": {
    "question": "What is machine learning?",
    "free": true
  }
}

GLM模型使用

{
  "name": "ask-glm",
  "arguments": {
    "question": "Translate this to Spanish: Hello, how are you?",
    "system_prompt": "You are a professional translator."
  }
}

故障排除

常见问题

1. “未配置OpenRouter API密钥”

- 确保您已设置 OPENROUTER_API_KEY 环境变量 - 检查您的API密钥是否有效并具有信用

1. “未收到模型的响应”

- 检查您的OpenRouter帐户是否有足够的信用 - 验证该模型在OpenRouter上可用

1. 连接问题

- 确保您有互联网连接 - 检查OpenRouter API是否可以从您的网络访问

1. NPM包问题

- 尝试重新安装： npm uninstall -g ask-mcp && npm install -g ask-mcp - 检查Node.js版本（需要Node.js 16+）

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

欢迎投稿！请随时提交拉取请求。