S
SkillNav

Qiskit MCP Server

平台与服务

by qiskit

面向 Qiskit 量子计算的 MCP server，提供电路序列化及相关实用工具。

28GitHub

什么是 Qiskit MCP Server？

面向 Qiskit 量子计算的 MCP server，提供电路序列化及相关实用工具。

README

Qiskit MCP Servers

Tests License Python Version Code style: ruff Type checked: mypy

qiskit-mcp-server qiskit-ibm-runtime-mcp-server qiskit-ibm-transpiler-mcp-server qiskit-docs-mcp-server qiskit-gym-mcp-server

A collection of Model Context Protocol (MCP) servers that give AI assistants, LLMs, and agents seamless access to IBM Quantum services and Qiskit libraries. Generate quantum code, connect to real hardware, analyze backends, execute circuits, and search Qiskit documentation — all through a standardized protocol that works with any MCP-compatible client.

Quick Start

Prerequisites

  • Python 3.10+ (3.11+ recommended)
  • IBM Quantum account and API token (only required for IBM cloud servers: Runtime, Transpiler)

Install from PyPI

bash
# Install all servers (core + community)
pip install "qiskit-mcp-servers[all]"

# Install core servers only (default, excludes community)
pip install qiskit-mcp-servers
<details> <summary>Install individual servers</summary>
bash
pip install "qiskit-mcp-servers[qiskit]"          # Qiskit server only
pip install "qiskit-mcp-servers[runtime]"         # IBM Runtime server only
pip install "qiskit-mcp-servers[transpiler]"      # IBM Transpiler server only
pip install "qiskit-mcp-servers[docs]"            # Documentation server only
pip install "qiskit-mcp-servers[gym]"             # Qiskit Gym server only (community)
</details>

Install from Source

Each server runs independently — the directory name and command are the same:

bash
cd qiskit-mcp-server  # or any server directory
pip install -e .
qiskit-mcp-server

Configuration

Servers that connect to IBM Quantum cloud services require a QISKIT_IBM_TOKEN environment variable. See each server's README for the full list of environment variables and configuration options.

bash
export QISKIT_IBM_TOKEN="your_ibm_quantum_token_here"

Client Setup

All servers are compatible with any MCP client. Pick your client below.

Claude Code

Claude Code Video

bash
# No auth required
claude mcp add qiskit -- uvx qiskit-mcp-server
claude mcp add qiskit-docs -- uvx qiskit-docs-mcp-server
claude mcp add qiskit-gym -- uvx qiskit-gym-mcp-server

# Require QISKIT_IBM_TOKEN (https://quantum.ibm.com)
claude mcp add qiskit-ibm-runtime -e QISKIT_IBM_TOKEN=$QISKIT_IBM_TOKEN -- uvx qiskit-ibm-runtime-mcp-server
claude mcp add qiskit-ibm-transpiler -e QISKIT_IBM_TOKEN=$QISKIT_IBM_TOKEN -- uvx qiskit-ibm-transpiler-mcp-server

IBM Bob

IBM Bob Video

Add to your ~/.bob/settings/mcp_settings.json:

json
{
    "mcpServers": {
        "qiskit": {
            "command": "uvx",
            "args": ["qiskit-mcp-server"],
            "alwaysAllow": [],
            "disabled": false
        },
        "qiskit-docs": {
            "command": "uvx",
            "args": ["qiskit-docs-mcp-server"],
            "alwaysAllow": [],
            "disabled": false
        },
        "qiskit-gym": {
            "command": "uvx",
            "args": ["qiskit-gym-mcp-server"],
            "alwaysAllow": [],
            "disabled": false
        },
        "qiskit-ibm-runtime": {
            "command": "uvx",
            "args": ["qiskit-ibm-runtime-mcp-server"],
            "env": {
                "QISKIT_IBM_TOKEN": "<your IBM Quantum token>",
                "QISKIT_IBM_RUNTIME_MCP_INSTANCE": "<Optional: Your IBM Quantum instance CRN>"
            },
            "alwaysAllow": [],
            "disabled": false
        },
        "qiskit-ibm-transpiler": {
            "command": "uvx",
            "args": ["qiskit-ibm-transpiler-mcp-server"],
            "env": {
                "QISKIT_IBM_TOKEN": "<your IBM Quantum token>"
            },
            "alwaysAllow": [],
            "disabled": false
        }
    }
}
<details> <summary>Claude Desktop / Cline</summary>

Add to your claude_desktop_config.json:

json
{
  "mcpServers": {
    "qiskit": {
      "command": "uvx",
      "args": ["qiskit-mcp-server"]
    },
    "qiskit-docs": {
      "command": "uvx",
      "args": ["qiskit-docs-mcp-server"]
    },
    "qiskit-gym": {
      "command": "uvx",
      "args": ["qiskit-gym-mcp-server"]
    },
    "qiskit-ibm-runtime": {
      "command": "uvx",
      "args": ["qiskit-ibm-runtime-mcp-server"],
      "env": {
        "QISKIT_IBM_TOKEN": "your_ibm_quantum_token_here"
      }
    },
    "qiskit-ibm-transpiler": {
      "command": "uvx",
      "args": ["qiskit-ibm-transpiler-mcp-server"],
      "env": {
        "QISKIT_IBM_TOKEN": "your_ibm_quantum_token_here"
      }
    }
  }
}
</details> <details> <summary>MCP Inspector (interactive testing)</summary>
bash
npx @modelcontextprotocol/inspector uvx qiskit-mcp-server
npx @modelcontextprotocol/inspector uvx qiskit-docs-mcp-server
npx @modelcontextprotocol/inspector uvx qiskit-ibm-runtime-mcp-server
# etc.
</details>

Available Servers

Core Servers

ServerDescriptionDirectory
Qiskit MCP ServerCircuit creation, transpilation, and serialization (QASM3, QPY) using Qiskitqiskit-mcp-server/
Qiskit IBM RuntimeFull access to IBM Quantum hardware via Qiskit IBM Runtimeqiskit-ibm-runtime-mcp-server/
Qiskit IBM TranspilerAI-optimized circuit routing and optimization via qiskit-ibm-transpilerqiskit-ibm-transpiler-mcp-server/
Qiskit DocsSearch and retrieve Qiskit documentation, guides, and API references. No auth required.qiskit-docs-mcp-server/

Community Servers

ServerDescriptionDirectory
Qiskit GymRL-based quantum circuit synthesis using qiskit-gym (permutation routing, linear functions, Clifford circuits)qiskit-gym-mcp-server/

Removed Servers

  • Qiskit Code Assistant MCP Server — previously published as qiskit-code-assistant-mcp-server. Removed because the underlying Qiskit Code Assistant service has been discontinued by IBM Quantum. See the sunset announcement. The PyPI package is archived and no longer maintained.

Examples

Each server includes an examples/ directory with a Jupyter notebook (langchain_agent.ipynb) and a Python script (langchain_agent.py) showing how to build AI agents with LangChain.

The root examples/ directory contains a multi-agent Quantum Volume Finder that orchestrates multiple MCP servers to find the highest achievable Quantum Volume on IBM Quantum hardware. See the examples README for details.

Architecture

All servers are built on FastMCP and share a consistent structure:

  • Async-first — all tool and resource handlers are async, using FastMCP's native async support
  • Standalone packages — each server is an independent PyPI package with its own pyproject.toml, tests, and CI
  • MCP Registry — every server ships a server.json manifest for automatic discovery
  • Unified meta-package — qiskit-mcp-servers installs any combination via pip extras
  • Full MCP protocol — tools (quantum operations), resources (backend info, service status), and stdio transport

Development

Running Tests

bash
cd qiskit-mcp-server  # or any server directory
./run_tests.sh

Code Quality

  • Linting: ruff check and ruff format
  • Type checking: mypy src/
  • Testing: pytest with async support and coverage reporting
  • CI/CD: GitHub Actions for automated testing

Resources

Contributing

Contributions are welcome! Please see the CONTRIBUTING.md guide for details.

License

This project is licensed under the Apache License 2.0.

常见问题

Qiskit MCP Server 是什么？

面向 Qiskit 量子计算的 MCP server，提供电路序列化及相关实用工具。

相关 Skills

Slack动图

by anthropics

Universal
热门

面向Slack的动图制作Skill，内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程，适合把创意或上传图片快速做成可直接发送的Slack动画。

✎ 帮你快速做出适配 Slack 的动图，内置约束规则和校验工具，少踩上传与播放坑，做表情包和演示都更省心。

平台与服务
未扫描164.6k

MCP构建

by anthropics

Universal
热门

聚焦高质量 MCP Server 开发，覆盖协议研究、工具设计、错误处理与传输选型，适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。

✎ 想让 LLM 稳定调用外部 API，就用 MCP构建：从 Python 到 Node 都有成熟指引，帮你更快做出高质量 MCP 服务器。

平台与服务
未扫描164.6k

接口测试套件

by alirezarezvani

Universal
热门

扫描 Next.js、Express、FastAPI、Django REST 的 API 路由，自动生成覆盖鉴权、参数校验、错误码、分页、上传与限流场景的 Vitest 或 Pytest 测试套件。

✎ 帮你把API与集成测试自动化跑顺，减少回归漏测；能力全面，尤其适合复杂接口场景的QA团队。

平台与服务
未扫描23.3k

相关 MCP Server

Slack 消息

编辑精选

by Anthropic

热门

Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。

✎ 这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点，特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过，它目前只是参考实现，文档有限，不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。

平台与服务
89.0k

io.github.netdata/mcp-server

编辑精选

by netdata

热门

io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。

✎ 这个工具解决了运维人员需要手动检查系统状态的痛点，最适合 DevOps 团队让 Claude 自动分析性能数据。不过，它依赖 NetData 的现有部署，如果你没用过这个监控平台，得先花时间配置。

平台与服务
79.5k

Scrapling MCP Server

编辑精选

by d4vinci

热门

Scrapling MCP Server 是专为现代网页设计的智能爬虫工具，支持绕过 Cloudflare 等反爬机制。

✎ 这个工具解决了爬取动态网页和反爬网站时的头疼问题，特别适合需要批量采集电商价格或新闻数据的开发者。不过，它依赖外部浏览器引擎，资源消耗较大，不适合轻量级任务。

平台与服务
71.5k

评论