Spinqit_task_manager

spinqit_mcp_tools インストールガイド

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

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

目次

• 前提条件

• 手動インストール

• スクリプトのインストール手順

  • Windows

  • macOS

  • 出力結果

  • トラブルシューティング

• cursor

• vscode-cline

• ライセンス

前提条件

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

• Python 3.10 以降：spinqit_mcp_tools には Python 3.10 以降が必要です。

• Conda（任意）：Python 3.10 がインストールされていない場合、スクリプトは Anaconda を使用して環境を作成できます。Anaconda からダウンロードしてください。

• インターネット接続：pip を使用して spinqit_mcp_tools パッケージをダウンロードするために必要です。

• macOS のターミナル権限：ターミナルが bash に対応していることを確認してください。

手動インストール

インストールスクリプトを使用せずに手動で spinqit_mcp_tools をインストールすることもできます。以下の手順に従ってください。スクリプトを使ったインストールとの違いは、初心者が設定しやすいように、スクリプトでは最後に Python のパスとプログラムを起動するためのコマンド全体が表示されることだけです。

• Python 3.10 以降をインストールする：

  • Python 公式サイトから Python 3.10 以降をダウンロードしてインストールしてください。または、Anaconda を使って Python をインストールしてください。

• spinqit_mcp_tools をインストールする：

  • ターミナルまたはコマンドプロンプトを開き、次のコマンドを実行してください。

      pip install spinqit_mcp_tools
    

• インストールが成功したことを確認する：

  • ターミナルまたはコマンドプロンプトで、次のコマンドを実行して正常に動作するか確認してください。

      python -m spinqit_mcp_tools.qasm_submitter
    

  • 「FastMCP initialized successfully, Tool registered」というメッセージが表示された場合、インストールは成功です。

• MCP サーバーを設定する：

スクリプトのインストール手順

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 を作成してクラウドプラットフォームに送信し、結果を確認する）

• Cursor

  • 設定方法

  

  • 結果

  

  • 設定

    {
      "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>"
          }
        }
      }
    }
    

  • 設定方法

  

  • 結果

  

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。