SpinQit MCP Tools

spinqit_mcp_tools インストールガイド

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

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

目次

• 前提条件
• スクリプトによるインストール手順
  • 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 が利用できる場合：スクリプトは Python 3.10 を使用して mcp-server-py310 という名前の Conda 環境を作成し、依存関係をインストールして、環境のパスと実行コマンドを出力します。
   • 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 などの実行コマンドを控えてください。
   • SpinQ Cloud でアカウントを登録し、公開鍵を設定して、MCP サーバーの設定に PRIVATEKEYPATH、SPINQCLOUDUSERNAME、SPINQCLOUDHOST を追加してください。デフォルトのホストは http://cloud.spinq.cn:6060 ですが、ほかのホストアドレスもサポートされています。

macOS

1. スクリプトをダウンロード

   • 次のリンクから mcpenv-installer-mac.sh スクリプトをダウンロードします。

     macOS インストールスクリプトをダウンロード

2. スクリプトを実行

   • 次のコマンドでスクリプトを実行します。

     sudo bash ./mcpenv-installer-mac.sh
     

3. スクリプトの動作

   • macOS スクリプトの動作は Windows スクリプトと同様です。
     • 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>",
            "SPINQCLOUDHOST": "http://cloud.spinq.cn:6060"
          }
        }
      }
    }
    

• VSCode Cline Plugin

  • 設定：

    {
      "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>",
            "SPINQCLOUDHOST": "http://cloud.spinq.cn:6060"
          }
        }
      }
    }
    

  • 設定方法

    

  • 結果

    

手動インストール手順

• Python 3.10 をインストールしてから、以下を実行します。

  pip install spinqit_mcp_tools
  

• MCP クライアントの起動コマンドとして python -m spinqit_mcp_tools.qasm_submitter を設定します。

• 必要な環境変数 PRIVATEKEYPATH、SPINQCLOUDUSERNAME、SPINQCLOUDHOST を設定します。

ライセンス

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