Qwen_Max

What is MCP-server-Qwen_Max?

MCP-server-Qwen_Max is an MCP (Model Context Protocol) server specifically designed for the Qwen series of large language models (Qwen-Max, Qwen-Plus, Qwen-Turbo). It allows applications that support the MCP protocol, such as Claude Desktop, to interact with and utilize the capabilities of Qwen models for text generation and other AI tasks.

How to use MCP-server-Qwen_Max?

There are two primary ways to install and use MCP-server-Qwen_Max:

Installation via Smithery (Recommended for Claude Desktop)

npx -y @smithery/cli install @66julienmartin/mcp-server-qwen_max --client claude

Manual Installation

1. Clone the repository:

   git clone https://github.com/66julienmartin/mcp-server-qwen-max.git
   cd Qwen_Max
   

2. Install dependencies:

   npm install
   

Configuration

1. Create a .env file in the project root and add your Dashscope API key:

   DASHSCOPE_API_KEY=your-api-key-here
   

2. Configure Claude Desktop (or your MCP-compatible application) to use the server:

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

Model Selection

By default, the server uses the qwen-max model. You can change the model by modifying the model parameter in src/index.ts to qwen-plus or qwen-turbo.

Key Features of MCP-server-Qwen_Max

• Qwen Model Integration: Seamlessly integrates with Qwen-Max, Qwen-Plus, and Qwen-Turbo models.
• MCP Protocol Support: Complies with the Model Context Protocol for broad compatibility.
• Claude Desktop Integration: Specifically designed for easy setup and use with Claude Desktop.
• Configurable Parameters: Allows adjustment of max_tokens and temperature for fine-grained control over text generation.
• Error Handling: Provides detailed error messages for common issues like API authentication, invalid parameters, and rate limiting.
• Node.js/TypeScript Implementation: Built with Node.js/TypeScript for stability, type safety, and reliable integration.
• Extensive Token Context Windows: Supports the large context windows offered by Qwen models.

Use Cases of MCP-server-Qwen_Max

• AI-powered Applications: Develop applications that leverage Qwen models for various AI tasks.
• Text Generation: Generate human-like text for content creation, summarization, and more.
• Conversational AI: Build chatbots and virtual assistants powered by Qwen models.
• Prototyping and Development: Quickly prototype and test applications utilizing Qwen models within an MCP environment.
• Integration with Claude Desktop: Enhance Claude Desktop's capabilities by connecting it to powerful Qwen models.

FAQ about MCP-server-Qwen_Max

Q: Why is Node.js used for this implementation? A: Node.js/TypeScript provides stable and reliable integration with MCP servers, offering better type safety, error handling, and compatibility with Claude Desktop compared to other languages.

Q: What are the prerequisites for running MCP-server-Qwen_Max? A: You need Node.js (v18 or higher), npm, Claude Desktop, and a Dashscope API key.

Q: How can I change the Qwen model used by the server? A: You can modify the model parameter in src/index.ts to qwen-max, qwen-plus, or qwen-turbo.

Q: What does the temperature parameter do? A: The temperature parameter controls the randomness of the model's output. Lower values (0.0-0.7) result in more focused output, while higher values (0.7-1.0) lead to more creative and varied output.

Q: Where can I find more information about Qwen models? A: You can visit the Alibaba Cloud Model Documentation: https://www.alibabacloud.com/help/en/model-studio/getting-started/models?spm=a3c0i.23458820.2359477120.1.446c7d3f9LT0FY.

Qwen Max MCP Server

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

Why Node.js? This implementation uses Node.js/TypeScript as it currently provides the most stable and reliable integration with MCP servers compared to other languages like Python. The Node.js SDK for MCP offers better type safety, error handling, and compatibility with Claude Desktop.

Prerequisites

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

Installation

Installing via Smithery

To install Qwen Max MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @66julienmartin/mcp-server-qwen_max --client claude

Manual Installation

git clone https://github.com/66julienmartin/mcp-server-qwen-max.git
cd Qwen_Max
npm install

Model Selection

By default, this server uses the Qwen-Max model. The Qwen series offers several commercial models with different capabilities:

Qwen-Max

Provides the best inference performance, especially for complex and multi-step tasks.

Context window: 32,768 tokens

• Max input: 30,720 tokens
• Max output: 8,192 tokens
• Pricing: $0.0016/1K tokens (input),$0.0064/1K tokens (output)
• Free quota: 1 million tokens

Available versions:

• qwen-max (Stable)
• qwen-max-latest (Latest)
• qwen-max-2025-01-25 (Snapshot, also known as qwen-max-0125 or Qwen2.5-Max)

Qwen-Plus

Balanced combination of performance, speed, and cost, ideal for moderately complex tasks.

Context window: 131,072 tokens

• Max input: 129,024 tokens
• Max output: 8,192 tokens
• Pricing: $0.0004/1K tokens (input),$0.0012/1K tokens (output)
• Free quota: 1 million tokens

Available versions:

• qwen-plus (Stable)
• qwen-plus-latest (Latest)
• qwen-plus-2025-01-25 (Snapshot, also known as qwen-plus-0125)

Qwen-Turbo

Fast speed and low cost, suitable for simple tasks.

• Context window: 1,000,000 tokens
• Max input: 1,000,000 tokens
• Max output: 8,192 tokens
• Pricing: $0.00005/1K tokens (input),$0.0002/1K tokens (output)
• Free quota: 1 million tokens

Available versions:

• qwen-turbo (Stable)
• qwen-turbo-latest (Latest)
• qwen-turbo-2024-11-01 (Snapshot, also known as qwen-turbo-1101)

To modify the model, update the model name in src/index.ts:

// For Qwen-Max (default)
model: "qwen-max"

// For Qwen-Plus
model: "qwen-plus"

// For Qwen-Turbo
model: "qwen-turbo"

For more detailed information about available models, visit the Alibaba Cloud Model Documentation https://www.alibabacloud.com/help/en/model-studio/getting-started/models?spm=a3c0i.23458820.2359477120.1.446c7d3f9LT0FY.

Project Structure

qwen-max-mcp/
├── src/
│   ├── index.ts             # Main server implementation
├── build/                   # Compiled files
│   ├── index.js
├── LICENSE
├── README.md
├── package.json
├── package-lock.json
└── tsconfig.json

Configuration

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

DASHSCOPE_API_KEY=your-api-key-here

2. Update 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 server

Features

• Text generation with Qwen models
• Configurable parameters (max_tokens, temperature)
• Error handling
• MCP protocol support
• Claude Desktop integration
• Support for all Qwen commercial models (Max, Plus, Turbo)
• Extensive token context windows

API Usage

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

The Temperature Parameter

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

Lower values (0.0-0.7): More focused and deterministic outputs Higher values (0.7-1.0): More creative and varied outputs

Recommended temperature settings by 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 for common issues:

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

Contributing

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

License

MIT