spinqit-task-manager 0.1.6

A task manager for submitting QASM tasks to SpinQ Cloud via MCP

spinqit-mcp-server 安装指南

本项目提供适用于 Windows 和 macOS 的 spinqit-mcp-server 一键安装脚本。这些脚本会自动检查 Python 环境（需 3.10 或更高版本）并安装所需的 spinqit_task_manager 依赖包。如果系统中没有合适的 Python 环境，脚本会尝试使用 Conda 创建环境，或引导用户手动安装 Python。

目录

• 前置条件
• 安装步骤
  • Windows
  • macOS
• 输出结果
• 故障排除
• 许可证

前置条件

在运行安装脚本之前，请确保满足以下条件：

• Python 3.10 或更高版本：spinqit-mcp-server 要求 Python 3.10 或以上版本。
• Conda（可选）：如果系统中没有 Python 3.10，脚本可使用 Anaconda 创建环境。请从 Anaconda下载。
• 网络连接：需要联网以通过 pip 下载 spinqit_task_manager 依赖包。
• macOS 终端权限：确保终端支持 bash。

安装步骤

Windows

1. 下载脚本

   • 从以下链接下载 mcpenv-installer-win-x86_64.bat 脚本： 下载 Windows 安装脚本

2. 运行脚本

   • 双击mcpenv-installer-win-x86_64.bat，运行安装

3. 脚本行为

   • 如果系统中已安装 Python 3.10 或更高版本：脚本将直接安装 spinqit_task_manager 依赖包，并输出 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_task_manager.qasm_submitter），并且到cloud.spinq.cn注册账号配置您的公钥

macOS

1. 下载脚本

   • 从以下链接下载 mcpenv-installer-mac.sh 脚本： 下载 macOS 安装脚本

2. 运行脚本

   • 执行脚本：

     sudo bash ./mcpenv-installer-mac.sh
     

3. 脚本行为

   • 与 Windows 脚本类似，macOS 脚本会：
     • 检查是否存在 Python 3.10 或更高版本，如果存在则安装 spinqit_task_manager。
     • 如果没有 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_task_manager.qasm_submitter
  • macOS：/path/to/conda/envs/mcp-server-py310/bin/python -m spinqit_task_manager.qasm_submitter

请保存这些信息，用于配置和运行 spinqit-mcp-server。

故障排除

• 未找到 Python 或版本低于 3.10：
  • 从 Python 官网 下载并安装 Python 3.10，确保添加到 PATH。
  • 安装完成后重新运行脚本。
• Conda 未被识别：
  • 在没有python 3.10以上版本时确保已安装 Anaconda，并将其添加到 PATH。
• pip 安装失败：
  • 检查网络连接是否正常。
• Conda 环境创建失败：
  • 检查 Conda 安装是否完整，或从 Anaconda 官网 重新安装。

使用

• 根据python安装目录使用：
  • /pathtopython/python -m spinqit_task_manager.qasm_submitter

环境测试情况 （创建并提交一个2比特量子线路qasm到云平台，并查看结果）

• 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_task_manager.qasm_submitter"
          ],
          "env": {
            "PRIVATEKEYPATH": "C:\\Users\\ylin\\.ssh\\id_rsa",
            "SPINQCLOUDUSERNAME": "a492760446"
          }
        }
      }
    }
    

  • 配置方式
    • 
  • 结果
    • 

• cursor

  • 配置项

    {
      "mcpServers": {
        "qasm-submitter": {
          "type": "stdio",
          "command": "cmd",
          "args": [
            "/C",
            "C:\\Users\\ylin\\.conda\\envs\\mcp-server-py310\\python.exe",
            "-m",
            "spinqit_task_manager.qasm_submitter"
          ],
          "env": {
            "PYTHONPATH":"/opt/anaconda3/envs/testmcpenv/bin/python",
            "PRIVATEKEYPATH":"/Users/yucheng/.ssh/id_rsa",
            "SPINQCLOUDUSERNAME":"a492760446"
          }
        }
      }
    }
    

  • 配置方式
    • 
  • 结果
    • 

许可证

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