Qwen Max

🚀 Qwen Max MCP サーバー

このプロジェクトは、Qwen Max 言語モデル用の Model Context Protocol (MCP) サーバーの実装です。Qwen Max モデルを使用した自然言語処理タスクを効率的に実行するためのサーバー環境を提供します。

なぜ 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

モデルの選択

1. Qwen Max モデル
   • 4K tokens を超える超长コンテキストウィンドウをサポート
   • 高性能な推論
2. Qwen Plus モデル
   • 性能とリソース消費のバランスが良い
3. Qwen Turbo モデル
   • 速度と応答時間が最適化されている

プロジェクト構造

- 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   # サーバーの起動

✨ 主な機能

• Qwen モデルのテキスト生成をサポート
• パラメータ（max_tokens、temperature）の設定が可能
• エラー処理機能
• MCP プロトコルのサポート
• Claude Desktop との統合
• すべての Qwen 商用モデル（Max、Plus、Turbo）をサポート
• 広範なコンテキストウィンドウをサポート

💻 使用例

基本的な使用法

// サンプルのツール呼び出し
{
  "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 認証エラー
• 無効なパラメータ
• レート制限
• ネットワーク問題
• Token 制限超過
• モデルの可用性問題

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。