Spinqit MCP Tools

🚀 spinqit_mcp_tools インストールガイド

このプロジェクトは、mcp-serverに基づいており、AI大規模モデルによるspinqの量子コンピューティングハードウェアリソースの効率的な呼び出しをサポートします。

このプロジェクトでは、WindowsとmacOSでspinqit_mcp_toolsのワンクリックインストールスクリプトを提供しています。これらのスクリプトは、Python環境（Python 3.10以上が必要）を自動的にチェックし、必要なspinqit_mcp_tools依存パッケージをインストールします。適切なPython環境が見つからない場合、スクリプトはCondaを使用して環境を作成しようとするか、ユーザーにPythonを手動でインストールするよう案内します。

🚀 クイックスタート

このガイドでは、spinqit_mcp_toolsのインストール方法について説明します。

📦 インストール

目次

• 前提条件
• スクリプトによるインストール手順
  • Windows
  • macOS
  • 出力結果
  • トラブルシューティング
• 手動インストール手順
• ライセンス

前提条件

インストールスクリプトを実行する前に、以下の要件を満たしていることを確認してください。

• Python 3.10以上：spinqit_mcp_toolsはPython 3.10以降が必要です。
• Conda（オプション）：Python 3.10がインストールされていない場合、スクリプトはAnacondaを使用して環境を作成できます。Anacondaからダウンロードしてください。
• インターネット接続：pipを介してspinqit_mcp_toolsパッケージをダウンロードするために必要です。
• macOSのターミナル権限：ターミナルがbashをサポートしていることを確認してください。

スクリプトによるインストール手順

Windows

1. スクリプトのダウンロード
   • 以下のリンクからmcpenv-installer-win-x86_64.batスクリプトをダウンロードします。 Windowsインストールスクリプトをダウンロード
2. スクリプトの実行
   • mcpenv-installer-win-x86_64.batをダブルクリックしてインストールを実行します。
3. スクリプトの動作
   • Python 3.10以上がすでにインストールされている場合：スクリプトは直接spinqit_mcp_toolsパッケージをインストールし、Python環境のパスとmcp-serverの実行コマンドを出力します。
   • Python 3.10がインストールされていないがCondaが利用可能な場合：スクリプトはmcp-server-py310という名前のConda環境（Python 3.10を使用）を作成し、依存関係をインストールし、環境のパスと実行コマンドを出力します。
   • Python 3.10もCondaもインストールされていない場合：スクリプトは、Python公式サイトまたはAnaconda公式サイトからPython 3.10またはCondaをダウンロードしてインストールするよう促します。インストール後、スクリプトを再実行してください。
4. インストール成功
   • 実行コマンド（例：この例ではC:\ProgramData\Anaconda3\envs\mcp-server-py310\python.exe -m spinqit_mcp_tools.qasm_submitter）をメモし、cloud.spinq.cnでアカウントを登録して公開鍵を設定します。
   • 実行コマンド、PRIVATEKEYPATH、SPINQCLOUDUSERNAMEをmcpサーバーの設定に入力します。

macOS

1. スクリプトのダウンロード
   • 以下のリンクからmcpenv-installer-mac.shスクリプトをダウンロードします。 macOSインストールスクリプトをダウンロード
2. スクリプトの実行
   • 以下のコマンドでスクリプトを実行します。

     sudo bash ./mcpenv-installer-mac.sh
     

3. スクリプトの動作
   • Windowsのスクリプトと同様に、macOSのスクリプトは以下のことを行います。
     • Python 3.10以上をチェックします。見つかった場合は、spinqit_mcp_toolsをインストールします。
     • Python 3.10が見つからない場合は、Condaをチェックし、mcp-server-py310環境を作成します。
     • Python 3.10もCondaもインストールされていない場合は、Python 3.10またはCondaをインストールしてからスクリプトを再実行するよう促します。

出力結果

スクリプトが正常に実行された後、以下の情報が出力されます。

• Python環境のパス：Python実行可能ファイルのパス。例：
  • Windows：C:\path\to\conda\envs\mcp-server-py310\python.exe
  • macOS：/path/to/conda/envs/mcp-server-py310/bin/python
• mcp-serverの実行コマンド：mcp-serverを実行するためのコマンド。例：
  • Windows：C:\path\to\conda\envs\mcp-server-py310\python.exe -m spinqit_mcp_tools.qasm_submitter
  • macOS：/path/to/conda/envs/mcp-server-py310/bin/python -m spinqit_mcp_tools.qasm_submitter

この情報をspinqit_mcp_toolsの設定と実行に使用してください。

トラブルシューティング

• Pythonが見つからないまたはバージョンが3.10未満：
  • Python公式サイトからPython 3.10をダウンロードしてインストールし、PATHに追加してください。
  • インストール後、スクリプトを再実行してください。
• Condaが認識されない：
  • Python 3.10以上が存在しない場合、Anacondaがインストールされており、PATHに追加されていることを確認してください。
• pipインストール失敗：
  • インターネット接続を確認してください。
• Conda環境の作成失敗：
  • Condaが正しくインストールされていることを確認するか、Anaconda公式サイトから再インストールしてください。

使用方法

• Pythonのインストールディレクトリを使用して実行します。
  • /pathtopython/python -m spinqit_mcp_tools.qasm_submitter

環境テスト（2量子ビットの量子回路QASMを作成してクラウドプラットフォームに送信し、結果を表示する）

• カーソル
  • 設定方法
  • 結果
  • 設定

    {
      "mcpServers": {
        "qasm-submitter": {
          "type": "stdio",
          "command": "cmd",
          "args": [
            "/C",
            "C:\\Users\\ylin\\.conda\\envs\\mcp-server-py310\\python.exe",
            "-m",
            "spinqit_mcp_tools.qasm_submitter"
          ],
          "env": {
            "PRIVATEKEYPATH":"<Your Privatekey Path>",
            "SPINQCLOUDUSERNAME":"<Your SpinQ Cloud Username>"
          }
        }
      }
    }
    

• VSCodeクライアントプラグイン
  • 設定

    {
      "mcpServers": {
        "qasm-submitter": {
          "disabled": false,
          "timeout": 60,
          "transportType": "stdio", 
          "command": "cmd",
          "args": [
            "/C",
            "C:\\Users\\ylin\\.conda\\envs\\mcp-server-py310\\python.exe",
            "-m",
            "spinqit_mcp_tools.qasm_submitter"
          ],
          "env": {
            "PRIVATEKEYPATH": "<Your Privatekey Path>",
            "SPINQCLOUDUSERNAME": "<Your SpinQ Cloud Username>"
          }
        }
      }
    }
    

  • 設定方法
  • 結果

手動インストール手順

• Python 3.10以上をインストールした後、pip install spinqit_mcp_toolsを実行します。
• python -m spinqit_mcp_tools.qasm_submitterをmcpクライアントの起動コマンドとして設定します。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。