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 文件。