关键词

Qwen Max大语言模型文本生成MCP服务器Claude Desktop

Qwen Max MCP Server 使用说明

项目简介

Qwen Max MCP Server 是一个使用 Node.js 开发的 MCP 服务器，它允许 MCP 客户端（如 Claude Desktop）通过 Model Context Protocol 协议调用阿里云的 Qwen Max、Qwen Plus 和 Qwen Turbo 大语言模型进行文本生成。该服务器实现了 MCP 协议的核心功能，能够作为 LLM 应用的后端，提供安全、可扩展的上下文服务。

主要功能点

  • 文本生成: 支持使用阿里云 Qwen Max 系列模型（Max, Plus, Turbo）生成文本。
  • 模型选择: 可以灵活配置和切换使用的 Qwen 模型版本。
  • 参数配置: 支持配置文本生成的关键参数，如 'max_tokens' (最大生成 tokens 数量) 和 'temperature' (生成文本的随机性)。
  • MCP 协议支持: 完全实现了 Model Context Protocol 协议，可以与任何标准的 MCP 客户端进行通信。
  • Claude Desktop 集成: 特别优化了与 Claude Desktop 的集成，可以通过 Claude Desktop 配置直接使用。
  • 错误处理: 提供详细的错误处理机制，帮助开发者快速定位和解决问题。

安装步骤

  1. 安装 Node.js: 确保你的系统已安装 Node.js (v18 或更高版本) 和 npm。你可以从 Node.js 官网 下载安装。

  2. 克隆仓库: 使用 git 克隆 Qwen Max MCP Server 仓库到本地：

    git clone https://github.com/66julienmartin/MCP-server-Qwen_Max.git
cd MCP-server-Qwen_Max

  3. 安装依赖: 在仓库根目录下运行 npm 命令安装项目依赖：

    npm install

  4. 配置 API Key:

    • 在项目根目录下创建 '.env' 文件。
    • 在 '.env' 文件中添加你的 DashScope API Key。你需要在阿里云 DashScope 平台申请 API Key。 
      DASHSCOPE_API_KEY=你的DashScope_API_Key

  5. 构建项目: 运行 npm 命令构建项目，将 TypeScript 代码编译为 JavaScript：

    npm run build

    构建成功后，会在项目根目录下生成 'build' 文件夹，编译后的 'index.js' 文件位于 'build' 文件夹内。

服务器配置 (Claude Desktop)

要将 Qwen Max MCP Server 集成到 Claude Desktop，你需要编辑 Claude Desktop 的配置文件，通常位于 '~/.claude/settings.json' (macOS/Linux) 或 '%APPDATA%\Claude\settings.json' (Windows)。

在 'settings.json' 文件中，找到 'mcpServers' 字段（如果没有则创建），并添加以下配置信息。请根据你的实际文件路径进行调整：

{
  "mcpServers": {
    "qwen_max": {
      "command": "node",
      "args": ["/path/to/MCP-server-Qwen_Max/build/index.js"],  // 替换为你的 Qwen_Max 项目 build 目录下的 index.js 文件的绝对路径
      "env": {
        "DASHSCOPE_API_KEY": "你的DashScope_API_Key" // 建议此处也填写 API Key，或者确保在运行环境中已设置环境变量
      }
    }
  }
}

配置参数说明:

  • '"qwen_max"': 服务器名称，在 Claude Desktop 中用于标识和选择该 MCP 服务器。你可以自定义名称。
  • '"command": "node"': 启动服务器的命令，这里使用 Node.js 运行环境。
  • '"args": ["/path/to/MCP-server-Qwen_Max/build/index.js"]': 启动命令的参数，指向编译后的服务器入口文件 'index.js' 的绝对路径。请务必将 '/path/to/MCP-server-Qwen_Max' 替换为你本地 Qwen_Max 项目的实际路径。
  • '"env": { "DASHSCOPE_API_KEY": "你的DashScope_API_Key" }': 设置环境变量。'DASHSCOPE_API_KEY' 用于服务器访问阿里云 DashScope API，建议在此处填写你的 API Key，或者确保你的运行环境中已经设置了 'DASHSCOPE_API_KEY' 环境变量。

基本使用方法

  1. 启动服务器: 在 Qwen Max MCP Server 项目根目录下，运行以下命令启动服务器：

    npm run start

    或者直接运行编译后的 JavaScript 文件:

    node build/index.js

    服务器成功启动后，会在控制台输出 'Qwen Max MCP server running on stdio'。

  2. 在 MCP 客户端中使用: 以 Claude Desktop 为例，在配置好 MCP 服务器后，你可以在 Claude Desktop 中选择 'qwen_max' 服务器。然后，你可以像使用普通的大语言模型一样，输入提示词 (prompt) 与 Qwen Max 模型进行对话和文本生成。

  3. 调用工具 (Tool Call): MCP 客户端会通过 Tool Call 的方式调用 Qwen Max Server 提供的文本生成工具。Tool Call 的 JSON 结构示例如下：

    {
  "name": "qwen_max",
  "arguments": {
    "prompt": "你的提示词",
    "max_tokens": 2048,  // 可选，最大生成 tokens 数量，默认为 8192
    "temperature": 0.7   // 可选，随机性参数，范围 0-2，默认为 0.7
  }
}

    在 MCP 客户端中，你需要构造类似的 Tool Call 请求，指定工具名称为 '"qwen_max"'，并在 'arguments' 中传递 'prompt' 等参数。服务器会将文本生成结果封装在 MCP 响应中返回给客户端。

注意事项

  • API Key 安全: 请妥善保管你的 DashScope API Key，避免泄露。
  • 模型选择: 你可以根据需求修改 'src/index.ts' 文件中的 'model' 字段来切换使用的 Qwen 模型 (qwen-max, qwen-plus, qwen-turbo)。
  • 错误日志: 服务器运行过程中如果出现错误，详细的错误信息会输出到控制台，请关注控制台日志以便排查问题。

信息

分类

AI与计算

访问项目