Qwen Max MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides access to Alibaba Cloud's Qwen family of language models (Max, Plus, Turbo) through the Dashscope API, allowing text generation with configurable parameters and support for large context windows up to 1 million tokens.

Qwen Max MCP 서버

Qwen Max 언어 모델을 위한 MCP(모델 컨텍스트 프로토콜) 서버 구현.

Node.js를 사용하는 이유는 무엇일까요? 이 구현은 Node.js/TypeScript를 사용합니다. Python과 같은 다른 언어에 비해 MCP 서버와의 통합이 가장 안정적이고 신뢰할 수 있기 때문입니다. MCP용 Node.js SDK는 더 나은 타입 안전성, 오류 처리 및 Claude Desktop과의 호환성을 제공합니다.

필수 조건

  • Node.js(v18 이상)
  • 엔피엠
  • 클로드 데스크탑
  • Dashscope API 키

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Qwen Max MCP Server를 자동으로 설치하려면:

지엑스피1

수동 설치

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

모델 선택

기본적으로 이 서버는 Qwen-Max 모델을 사용합니다. Qwen 시리즈는 다양한 기능을 갖춘 여러 상용 모델을 제공합니다.

퀀-맥스

특히 복잡하고 여러 단계로 구성된 작업에 대해 최고의 추론 성능을 제공합니다.

컨텍스트 창: 32,768개 토큰

  • 최대 입력: 30,720 토큰
  • 최대 출력: 8,192개 토큰
  • 가격: $0.0016/1K 토큰(입력), $0.0064/1K 토큰(출력)
  • 무료 할당량: 100만 토큰

사용 가능한 버전:

  • qwen-max(안정적)
  • qwen-max-latest (최신)
  • qwen-max-2025-01-25(스냅샷, qwen-max-0125 또는 Qwen2.5-Max라고도 함)

퀀플러스

성능, 속도, 비용의 균형 잡힌 조합으로, 적당히 복잡한 작업에 이상적입니다.

컨텍스트 창: 131,072개 토큰

  • 최대 입력: 129,024개 토큰
  • 최대 출력: 8,192개 토큰
  • 가격: $0.0004/1K 토큰(입력), $0.0012/1K 토큰(출력)
  • 무료 할당량: 100만 토큰

사용 가능한 버전:

  • qwen-plus(안정적)
  • qwen-plus-latest (최신)
  • qwen-plus-2025-01-25 (스냅샷, qwen-plus-0125라고도 함)

퀀-터보

속도가 빠르고 비용이 저렴하여 간단한 작업에 적합합니다.

  • 컨텍스트 창: 1,000,000개 토큰
  • 최대 입력: 1,000,000 토큰
  • 최대 출력: 8,192개 토큰
  • 가격: $0.00005/1K 토큰(입력), $0.0002/1K 토큰(출력)
  • 무료 할당량: 100만 토큰

사용 가능한 버전:

  • qwen-turbo(안정적)
  • qwen-turbo-latest (최신)
  • qwen-turbo-2024-11-01 (스냅샷, qwen-turbo-1101로도 알려짐)

모델을 수정하려면 src/index.ts에서 모델 이름을 업데이트하세요.

// For Qwen-Max (default) model: "qwen-max" // For Qwen-Plus model: "qwen-plus" // For Qwen-Turbo model: "qwen-turbo"

사용 가능한 모델에 대한 자세한 내용은 Alibaba Cloud 모델 설명서 https://www.alibabacloud.com/help/en/model-studio/getting-started/models?spm=a3c0i.23458820.2359477120.1.446c7d3f9LT0FY에서 확인하세요.

프로젝트 구조

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

구성

  1. 프로젝트 루트에 .env 파일을 만듭니다.
DASHSCOPE_API_KEY=your-api-key-here
  1. 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 # Watch mode npm run build # Build npm run start # Start server

특징

  • Qwen 모델을 사용한 텍스트 생성
  • 구성 가능한 매개변수(max_tokens, 온도)
  • 오류 처리
  • MCP 프로토콜 지원
  • Claude Desktop 통합
  • 모든 Qwen 상용 모델(Max, Plus, Turbo) 지원
  • 광범위한 토큰 컨텍스트 창

API 사용

// Example tool call { "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

오류 처리

서버는 일반적인 문제에 대한 자세한 오류 메시지를 제공합니다.

API 인증 오류 잘못된 매개변수 속도 제한 네트워크 문제 토큰 제한 초과 모델 가용성 문제

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

구성 가능한 매개변수와 MCP(Model Context Protocol)를 통한 Claude Desktop과의 원활한 통합을 통해 Qwen Max 언어 모델을 사용하여 텍스트를 생성할 수 있습니다.

  1. Prerequisites
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Model Selection
      1. Qwen-Max
      2. Qwen-Plus
      3. Qwen-Turbo
    3. Project Structure
      1. Configuration
        1. Development
          1. Features
            1. API Usage
              1. The Temperature Parameter
                1. Error Handling
                  1. Contributing
                    1. License
                      ID: 1v7po9oa9w