Qwen Max MCP 服务器实现

概述

该项目旨在实现对 Qwen 系列模型（包括 Qwen-Max、Qwen-Plus 和 Qwen-Turbo）的支持，通过 MCP 协议提供文本生成服务。采用 Node.js 和 TypeScript 进行开发，相较于 Python 具备更高的稳定性和可靠性。

安装方法

自动安装

使用 Smithery CLI 工具进行自动安装：

smith install Qwen_Max

手动安装

1. 克隆项目仓库：

   git clone https://github.com/your-username/Qwen_Max.git
   cd Qwen_Max
   

2. 安装依赖项：

   npm install
   

项目结构

Qwen_Max/
├── src/              # 源代码目录，包含主程序入口 index.ts 等
├── build/            # 编译后的生产文件
├── .env              # 环境变量配置文件
├── README.md         # 项目文档
├── package.json      # 依赖管理和运行脚本
└── tsconfig.json     # TypeScript 配置文件

配置

1. 创建 .env 文件并添加以下内容：

   DASHSCOPE_API_KEY=your-api-key-here
   

2. 更新 Claude Desktop 的配置文件 claudius.json：

   {
     "mcpServers": {
       "qwen_max": {
         "command": "node",
         "args": ["/path/to/Qwen_Max/build/index.js"],
         "env": {
           "DASHSCOPE_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

开发

npm run dev     # 启动开发模式，支持自动编译
npm run build   # 构建生产版本
npm run start   # 启动服务器

功能特性

• 文本生成：支持基于 Qwen 模型的文本生成。
• 可配置参数：允许设置 max_tokens 和 temperature 等参数。
• 错误处理：提供详细的错误信息，便于排查问题。
• MCP 协议支持：兼容 MCP 协议，实现与其他工具和服务的无缝集成。
• Claude Desktop 集成：与 Claude Desktop 工具深度整合。

API 使用示例

// 示例工具调用
{
  "name": "qwen_max",
  "arguments": {
    "prompt": "Your prompt here",
    "max_tokens": 8192,
    "temperature": 0.7
  }
}

温度参数说明

• 范围：0.0 至 1.0。
• 影响：
  • 较低值（0.0-0.7）：输出更加聚焦和确定性。
  • 较高值（0.7-1.0）：输出更具创造性和多样性。

推荐使用场景

• 代码生成：温度设为 0.0-0.3，确保输出的准确性和可靠性。
• 技术写作：温度设为 0.3-0.5，平衡准确性和一定的创造性。
• 通用任务：默认温度 0.7，适用于大多数场景。
• 创意写作：温度设为 0.8-1.0，激发创作灵感。

错误处理

服务器针对常见问题提供详细的错误信息：

• API 认证失败
• 参数无效
• 请求速率限制
• 网络连接问题
• 账号使用限制
• 模型服务异常

项目贡献

欢迎社区开发者积极参与项目的完善与优化，通过提交 Pull Request 贡献代码。

授权协议

本项目采用 MIT 许可证，允许用户自由使用、修改和分发项目代码。