量子比特MCP工具

Name: 量子比特MCP工具
Author: SpinQTech

作者：SpinQTech2 星标更新：2025-07-07

安装使用来源：spider==github.com

项目介绍

spinqit_mcp_tools 安装指南

<div align="right"> <a href="README_zh.md">中文</a> | <a href="README.md">English</a> </div> 本项目基于mcp-server支持AI大模型高效调用spinq量子计算硬件资源。

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

先决条件

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

Python 3.10或更高版本：spinqit_mcp_tools需要Python 3.10或更高版本。
Conda（可选）：如果未安装Python 3.10，脚本可以使用Anaconda来创建环境。从Anaconda下载。
互联网连接：用于通过pip下载spinqit_mcp_tools包。
macOS终端权限：确保终端支持bash。

脚本安装步骤

Windows

下载脚本
- 从以下链接下载mcpenv-installer-win-x86_64.bat脚本：
  
  <a href="https://static-cdn.spinq.cn/mcp_server_cmd/download_cmd.html?win">下载Windows安装脚本</a>
运行脚本
- 双击mcpenv-installer-win-x86_64.bat以执行安装。
脚本行为
- 如果已安装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。安装后重新运行脚本。
成功安装
- 注意执行命令（例如，在此示例中为C:\ProgramData\Anaconda3\envs\mcp-server-py310\python.exe -m spinqit_mcp_tools.qasm_submitter），并在cloud.spinq.cn注册账户以配置您的公钥。
- 将执行命令、PRIVATEKEYPATH、SPINQCLOUDUSERNAME输入到您的mcp服务器设置中。

macOS

下载脚本
- 从以下链接下载mcpenv-installer-mac.sh脚本：
  
  <a href="https://static-cdn.spinq.cn/mcp_server_cmd/download_cmd.html?mac">下载macOS安装脚本</a>
运行脚本
- 使用以下命令执行脚本：
```
sudo bash ./mcpenv-installer-mac.sh
```
脚本行为
- 类似于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：
- 确保已安装Anaconda并将其添加到PATH中，如果不存在Python 3.10或更高版本。
pip安装失败：
- 检查您的互联网连接。
Conda环境创建失败：
- 验证Conda是否正确安装，或从Anaconda官方网站重新安装它。

使用方法

使用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":"<您的私钥路径>",
        "SPINQCLOUDUSERNAME":"<您的SpinQ Cloud用户名>"
      }
    }
  }
}

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": "<您的私钥路径>",
        "SPINQCLOUDUSERNAME": "<您的SpinQ Cloud用户名>"
      }
    }
  }
}

配置方法

alt text

结果