Qwen Max

🚀 Qwen Max MCP Server

An implementation of the Model Context Protocol (MCP) server for the Qwen Max language model.

Why Node.js?

This implementation uses Node.js/TypeScript because it currently provides the most stable and reliable experience when integrating with MCP servers compared to other languages (e.g., Python). The Node.js SDK offers better type safety, error handling, and compatibility with Claude Desktop.

🚀 Quick Start

Prerequisites

• Node.js (v18 or higher)
• npm
• Claude Desktop
• Dashscope API key

📦 Installation

Install via Smithery

To automatically install the Qwen Max MCP server via Smithery:

npm install

Create a Configuration File

Create a .env file in the project root directory:

DASHSCOPE_API_KEY=your-api-key-here

Model Selection

1. Qwen Max Model
   • Supports an ultra-long context window (over 4K tokens)
   • High-performance inference
2. Qwen Plus Model
   • Balances performance and resource consumption
3. Qwen Turbo Model
   • Optimized for speed and response time

Project Structure

- Qwen_Max/
  ├── build/                 # Directory for compiled files
  ├── package.json          # Project dependencies and script configurations
  ├── tsconfig.json         # TypeScript configuration file
  └── README.md             # Project documentation

Configuration

1. Create a .env file in the project root directory:

DASHSCOPE_API_KEY=your-api-key-here

2. Update the Claude Desktop configuration:

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

Development

npm run dev     # Watch mode
npm run build   # Build
npm run start   # Start the server

✨ Features

• Supports text generation for Qwen models
• Configurable parameters (max_tokens, temperature)
• Error handling
• MCP protocol support
• Claude Desktop integration
• Supports all Qwen commercial models (Max, Plus, Turbo)
• Extensive context window support

💻 Usage Examples

Basic Usage

// Example tool call
{
  "name": "qwen_max",
  "arguments": {
    "prompt": "Your prompt here",
    "max_tokens": 8192,
    "temperature": 0.7
  }
}

Temperature Parameter Explanation

The temperature parameter controls the randomness of the model's output:

• Lower values (0.0 - 0.7): More focused and deterministic output
• Higher values (0.7 - 1.0): More creative and diverse output

It is recommended to adjust the temperature setting according to the task:

• Code generation: 0.0 - 0.3
• Technical writing: 0.3 - 0.5
• General tasks: 0.7 (default)
• Creative writing: 0.8 - 1.0

Error Handling

The server provides detailed error messages covering the following common issues:

• API authentication errors
• Invalid parameters
• Rate limits
• Network issues
• Token limit exceeded
• Model availability issues

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT