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。

目录

• 先决条件
• 脚本安装步骤
  • 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 注册账号，配置公钥，并将 PRIVATEKEYPATH、SPINQCLOUDUSERNAME 和 SPINQCLOUDHOST 添加到 MCP 服务设置中。默认主机为 http://cloud.spinq.cn:6060，也支持其他主机地址。

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-qubit 量子电路 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 插件

  • 配置设置：

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

• 将 python -m spinqit_mcp_tools.qasm_submitter 配置为 MCP 客户端启动命令。

• 设置所需的环境变量：PRIVATEKEYPATH、SPINQCLOUDUSERNAME 和 SPINQCLOUDHOST。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。