spinqit MCP tools

spinqit_mcp_tools安装指南

中文 | English

This project is based on mcp-server to support efficient invocation of spinq's quantum computing hardware resources by AI large models.

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

目录

• 先决条件

• 脚本安装步骤

- 视窗

- macOS

- 输出结果

- 故障排除

• 手动安装步骤

• 许可证

先决条件

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

• Python 3.10或更高版本: spinqit_mcp_tools 需要Python 3.10或更高版本。

• 康达（可选）：如果没有安装Python 3.10，脚本可以使用Anaconda创建环境。从下载 蟒蛇.

• Internet连接：下载所需 spinqit_mcp_tools 包裹通过 pip.

• macOS终端权限：确保终端支持 bash.

脚本安装步骤

视窗

1. 下载脚本

- 下载 mcpenv-installer-win-x86_64.bat 脚本来自以下链接：

下载Windows安装脚本

1. 运行脚本

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

1. 脚本行为

- 如果已安装Python 3.10或更高版本：脚本将直接安装 spinqit_mcp_tools 打包并输出Python环境路径和 mcp-server 执行命令。

- 如果未安装Python 3.10，但Conda可用：脚本将创建一个名为的Conda环境 mcp-server-py310 （使用Python 3.10），安装依赖项，并输出环境路径和执行命令。

1. 成功安装

- alt text

- 注意执行命令（例如。， C:\ProgramData\Anaconda3\envs\mcp-server-py310\python.exe -m spinqit_mcp_tools.qasm_submitter 在本例中）并在以下位置注册帐户 cloud.spinq.cn 配置您的公钥。

- 在mcp服务器设置中输入执行命令PRIVATEKYPATH、SPINQCLOUDUSERNAME

macOS

1. 下载脚本

- 下载 mcpenv-installer-mac.sh 脚本来自以下链接：

下载macOS安装脚本

1. 运行脚本

- 使用以下命令执行脚本：

     sudo bash ./mcpenv-installer-mac.sh

1. 脚本行为

- 与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环境创建失败:

- 验证Conda是否正确安装或从以下位置重新安装 Anaconda官方网站.

用法

• 使用Python安装目录运行：

- /pathtopython/python -m spinqit_mcp_tools.qasm_submitter

环境测试（创建2量子比特量子电路QASM并将其提交到云平台并查看结果）

• 光标

- 配置方法

alt text

- 结果

alt text

- 配置设置

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

• 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": ""
          }
        }
      }
    }

- 配置方法

alt text

- 结果

alt text

手动安装步骤

• 安装Python 3.10或更高版本，然后运行： pip install spinqit_mcp_tools

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

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。