🚀 Qwen Max MCP 服务器

Qwen Max MCP 服务器是一个专为 Qwen Max 语言模型打造的 Model Context Protocol (MCP) 服务器实现，能为相关应用提供稳定可靠的服务支持。

为什么选择 Node.js？

此实现采用 Node.js/TypeScript，相较于其他语言（如 Python），它在与 MCP 服务器集成方面能提供更稳定、可靠的体验。Node.js SDK 具备更好的类型安全、错误处理能力，还与 Claude Desktop 兼容。

🚀 快速开始

先决条件

• Node.js (v18 或更高版本)
• npm
• Claude Desktop
• Dashscope API 密钥

📦 安装指南

通过 Smithery 安装

若要通过 Smithery 自动安装 Qwen Max MCP 服务器，可执行以下命令：

npm install

创建配置文件

在项目根目录下创建一个 .env 文件，内容如下：

DASHSCOPE_API_KEY=your-api-key-here

✨ 主要特性

• 支持 Qwen 模型的文本生成。
• 可配置参数（max_tokens，temperature）。
• 具备完善的错误处理机制。
• 支持 MCP 协议。
• 可与 Claude Desktop 集成。
• 支持所有 Qwen 商业模型（Max、Plus、Turbo）。
• 支持广泛的上下文窗口。

💻 使用示例

模型选择

1. Qwen Max 模型
   • 支持超长上下文窗口（超过 4K tokens）。
   • 具备高性能推理能力。
2. Qwen Plus 模型
   • 能平衡性能与资源消耗。
3. Qwen Turbo 模型
   • 对速度和响应时间进行了优化。

API 使用示例

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

温度参数说明

温度参数用于控制模型输出的随机性：

• 较低值（0.0 - 0.7）：输出更专注、确定。
• 较高值（0.7 - 1.0）：输出更具创造性和多样性。

建议根据不同任务调整温度设置：

• 代码生成：0.0 - 0.3
• 技术写作：0.3 - 0.5
• 通用任务：0.7（默认）
• 创意写作：0.8 - 1.0

📚 详细文档

项目结构

- Qwen_Max/
  ├── build/                 # 编译生成的文件目录
  ├── package.json          # 项目依赖和脚本配置
  ├── tsconfig.json         # TypeScript 配置文件
  └── README.md             # 项目文档

配置

1. 在项目根目录中创建一个 .env 文件：

DASHSCOPE_API_KEY=your-api-key-here

2. 更新 Claude Desktop 配置：

{
  "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   # 启动服务器

错误处理

服务器会提供详细的错误消息，涵盖以下常见问题：

• API 认证错误
• 无效参数
• 速率限制
• 网络问题
• Token 限制超过
• 模型可用性问题

🔧 技术细节

此实现选用 Node.js/TypeScript，是因为其在与 MCP 服务器集成时能提供最稳定和可靠的体验。Node.js SDK 具有更好的类型安全、错误处理能力，并且与 Claude Desktop 兼容，这些特性使得该服务器在处理 Qwen 模型相关任务时表现出色。

📄 许可证

本项目采用 MIT 许可证。

贡献

欢迎大家积极贡献！请随意提交 Pull Request。