AI导哈

量子计算工具包

支持AI大模型高效调用SpinQ量子计算硬件资源的工具包。

  • by SpinQTech
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 SpinQTech/spinqit_mcp_tools

使用说明

spinqit_mcp_tools安装指南

中文 | English

该项目基于mcp服务器，支持AI大型模型高效调用SpinQ量子计算硬件资源。

此项目提供了一键安装脚本 spinqit_mcp_tools 在Windows和macOS上。这些脚本会自动检查Python环境（建议使用Python 3.10）并安装所需的 spinqit_mcp_tools 依赖包。如果没有找到合适的Python环境，脚本将尝试使用Conda创建一个环境，或指导用户手动安装Python。

目录

先决条件

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

  • Python 3.10推荐：当前使用Python 3.10 spinqit_mcp_tools 环境。
  • 康达（可选）：如果没有安装Python 3.10，脚本可以使用Anaconda创建环境。从这里下载 蟒蛇.
  • Internet连接：下载所需 spinqit_mcp_tools 包裹通过 pip.
  • macOS终端权限：确保终端支持 bash.

脚本安装步骤

视窗

  1. 下载脚本

  2. 运行脚本

    • 双击 mcpenv-installer-win-x86_64.bat 以执行安装。

  3. 脚本行为

    • 如果Python 3.10已经安装：脚本将直接安装 spinqit_mcp_tools 打包并输出Python环境路径和 mcp-server 执行命令。
    • 如果未安装Python 3.10，但Conda可用：脚本将创建一个名为的Conda环境 mcp-server-py310 使用Python 3.10，安装依赖项，并输出环境路径和执行命令。
    • 如果既没有安装Python 3.10也没有安装Conda：该脚本将提示您从以下网址下载并安装Python 3.10或Conda Python官方网站 或 Anaconda官方网站。安装后，重新运行脚本。

  4. 成功安装

    • 注意执行命令，例如 C:\ProgramData\Anaconda3\envs\mcp-server-py310\python.exe -m spinqit_mcp_tools.qasm_submitter.
    • 在以下网址注册帐户 SpinQ云，配置您的公钥，然后添加 PRIVATEKEYPATH, SPINQCLOUDUSERNAME，以及 SPINQCLOUDHOST 到您的MCP服务器设置。默认主机为 http://cloud.spinq.cn:6060，并且还支持其他主机地址。

macOS

  1. 下载脚本

  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可执行文件的路径，例如：
    • 窗户： C:\path\to\conda\envs\mcp-server-py310\python.exe
    • macOS： /path/to/conda/envs/mcp-server-py310/bin/python
  • mcp服务器执行命令：要运行的命令 mcp-server例如：
    • 窗户： 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 3.10 Python官方网站，确保将其添加到PATH中。
    • 安装后重新运行脚本。
  • Conda未被识别:
    • 如果Python 3.10不存在，请确保Anaconda已安装并添加到PATH中。
  • 管道安装失败:
    • 检查您的互联网连接。
  • Conda环境创建失败:

用法

使用Python安装目录运行：

/pathtopython/python -m spinqit_mcp_tools.qasm_submitter

环境测试

创建2量子比特量子电路QASM并将其提交到云平台并查看结果。

  • 光标

    • 配置方法

    • 结果

    • 配置设置

      {
  "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临床插件

    • 配置设置：

      {
  "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许可证获得许可。请参阅 许可证 文件以获取详细信息。

相关 MCP