Qiskit IBM Transpiler MCP Server — MCP-сервер для Claude Code
MCP-сервер, через который агент прогоняет квантовые схемы через ИИ-транспилятор Qiskit IBM: роутинг и синтез на бэкендах IBM Quantum. Пригодится, если схемы готовятся для реального железа.
claude mcp add qiskit-ibm-transpiler-mcp-server -e QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> -- uvx qiskit-ibm-transpiler-mcp-serverЧто делает Qiskit IBM Transpiler MCP Server
Сервер отдаёт агенту инструменты транспилятора Qiskit IBM. Роутинг расставляет SWAP-операции, чтобы двухкубитные гейты укладывались в coupling map выбранного бэкенда. Дальше идут проходы синтеза: AI Clifford, AI Linear Function, AI Permutation и AI Pauli Network. Всё это работает в формате QASM 3.0.
На вход принимаются и строка QASM 3.0, и base64-кодированный QPY. На выходе QPY — так точнее, когда один проход передаёт схему следующему. Аккаунт IBM Quantum настраивается отдельным инструментом: токен можно передать параметром, положить в переменную QISKIT_IBM_TOKEN или сохранить в ~/.qiskit/qiskit-ibm.json. Если учётка уже сохранена, шаг с настройкой пропускается.
Нужен Python от 3.10 до 3.14, qiskit-ibm-transpiler версии 0.15.0 и fastmcp не ниже 2.12.4. Без токена IBM Quantum проходы синтеза не поедут: роутинг и синтез выполняются на стороне сервиса IBM, а не локально.
Какие задачи решает
- подогнать двухкубитные гейты под coupling map конкретного бэкенда
- прогнать схему через ИИ-синтез Clifford в QASM 3.0
- передать схему между проходами без потери точности через QPY
- настроить доступ к IBM Quantum прямо из чата с агентом
- сверить результат синтеза на бэкенде вроде
ibm_fez
Примеры запросов агенту
- Синтезируй эту схему Clifford для бэкенда
ibm_fez:OPENQASM 3.0; include "stdgates.inc"; qubit[3] q; h q[0]; cx q[0], q[1]; s q[2]; - Сначала сделай AI-роутинг этой схемы под бэкенд, потом прогони AI Clifford-синтез через QPY
- Настрой аккаунт IBM Quantum по токену из
QISKIT_IBM_TOKENи проверь, что доступ работает
Как установить Qiskit IBM Transpiler MCP Server
Командой платформы
claude mcp add qiskit-ibm-transpiler-mcp-server -e QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> -- uvx qiskit-ibm-transpiler-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from qiskit-ibm-transpiler-mcp-server <команда>
Командой платформы
codex mcp add qiskit-ibm-transpiler-mcp-server --env QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> -- uvx qiskit-ibm-transpiler-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from qiskit-ibm-transpiler-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"qiskit-ibm-transpiler-mcp-server": {
"command": "uvx",
"args": [
"qiskit-ibm-transpiler-mcp-server"
],
"env": {
"QISKIT_IBM_TOKEN": "<QISKIT_IBM_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from qiskit-ibm-transpiler-mcp-server <команда>
Файл настроек
{
"servers": {
"qiskit-ibm-transpiler-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"qiskit-ibm-transpiler-mcp-server"
],
"env": {
"QISKIT_IBM_TOKEN": "<QISKIT_IBM_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from qiskit-ibm-transpiler-mcp-server <команда>
Командой платформы
gemini mcp add -e QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> qiskit-ibm-transpiler-mcp-server uvx qiskit-ibm-transpiler-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from qiskit-ibm-transpiler-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Qiskit IBM Transpiler MCP Server
Как установить Qiskit IBM Transpiler MCP Server в Claude Code?
Одной командой: claude mcp add qiskit-ibm-transpiler-mcp-server -e QISKIT_IBM_TOKEN=<QISKIT_IBM_TOKEN> -- uvx qiskit-ibm-transpiler-mcp-server. Подставьте свой токен IBM Quantum вместо плейсхолдера.
Что делает этот MCP-сервер?
Даёт агенту инструменты транспилятора Qiskit IBM: роутинг схемы под coupling map бэкенда и ИИ-синтез Clifford, Linear Function, Permutation и Pauli Network. Вход и выход — QASM 3.0 или QPY.
Что нужно, чтобы сервер заработал?
Python от 3.10 до 3.14, пакеты qiskit-ibm-transpiler==0.15.0 и fastmcp>=2.12.4, а также токен IBM Quantum в QISKIT_IBM_TOKEN или в сохранённых учётных данных.
