Qwen Max

🚀 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。