MCP Server Qwen Max

🚀 Qwen Max MCP 服務器實現

本項目致力於實現對 Qwen 系列模型（涵蓋 Qwen - Max、Qwen - Plus 和 Qwen - Turbo）的支持，藉助 MCP 協議提供文本生成服務。採用 Node.js 和 TypeScript 開發，相比 Python 具有更高的穩定性和可靠性。

🚀 快速開始

本項目支持自動和手動兩種安裝方式，安裝完成後可按指引進行配置和啟動。

✨ 主要特性

• 文本生成：支持基於 Qwen 模型的文本生成。
• 可配置參數：允許設置 max_tokens 和 temperature 等參數。
• 錯誤處理：提供詳細的錯誤信息，便於排查問題。
• MCP 協議支持：兼容 MCP 協議，實現與其他工具和服務的無縫集成。
• Claude Desktop 集成：與 Claude Desktop 工具深度整合。

📦 安裝指南

自動安裝

使用 Smithery CLI 工具進行自動安裝：

smith install Qwen_Max

手動安裝

1. 克隆項目倉庫：

   git clone https://github.com/your-username/Qwen_Max.git
   cd Qwen_Max
   

2. 安裝依賴項：

   npm install
   

📚 詳細文檔

項目結構

Qwen_Max/
├── src/              # 源代碼目錄，包含主程序入口 index.ts 等
├── build/            # 編譯後的生產文件
├── .env              # 環境變量配置文件
├── README.md         # 項目文檔
├── package.json      # 依賴管理和運行腳本
└── tsconfig.json     # TypeScript 配置文件

配置

1. 創建 .env 文件並添加以下內容：

   DASHSCOPE_API_KEY=your-api-key-here
   

2. 更新 Claude Desktop 的配置文件 claudius.json：

   {
     "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   # 啟動服務器

💻 使用示例

基礎用法

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

溫度參數說明

• 範圍：0.0 至 1.0。
• 影響：
  • 較低值（0.0 - 0.7）：輸出更加聚焦和確定性。
  • 較高值（0.7 - 1.0）：輸出更具創造性和多樣性。

推薦使用場景

• 代碼生成：溫度設為 0.0 - 0.3，確保輸出的準確性和可靠性。
• 技術寫作：溫度設為 0.3 - 0.5，平衡準確性和一定的創造性。
• 通用任務：默認溫度 0.7，適用於大多數場景。
• 創意寫作：溫度設為 0.8 - 1.0，激發創作靈感。

🔧 技術細節

服務器針對常見問題提供詳細的錯誤信息：

• API 認證失敗
• 參數無效
• 請求速率限制
• 網絡連接問題
• 賬號使用限制
• 模型服務異常

🤝 項目貢獻

歡迎社區開發者積極參與項目的完善與優化，通過提交 Pull Request 貢獻代碼。

📄 許可證

本項目採用 MIT 許可證，允許用戶自由使用、修改和分發項目代碼。