Qiskit MCP 서버

Qiskit MCP 서버는 양자 컴퓨팅 기능을 AI 시스템에 통합하는 Model Context Protocol (MCP) 서버 모음입니다. 이 서버들을 통해 AI 어시스턴트, 대규모 언어 모델(LLM), 에이전트가 IBM Quantum® 서비스와 Qiskit 라이브러리에 접근할 수 있습니다.

참고

이것은 오픈 소스 프로젝트입니다. 최신 정보, 상세한 API 범위, 고급 설정에 대해서는 Qiskit MCP 서버 GitHub 저장소를 참고하세요.

Qiskit MCP 서버를 언제 사용해야 하나요?

Qiskit MCP 서버를 사용하면 AI 어시스턴트가 다음과 같은 양자 컴퓨팅 작업을 도울 수 있습니다:

• 양자 Circuit 생성, 조작 및 트랜스파일

• Qiskit 문서, 가이드 및 API 레퍼런스 검색 및 조회

• 신뢰할 수 있는 소스에서 직접 양자 컴퓨팅 질문에 답변

• 문맥 인식을 통한 양자 코드 생성

• AI 기반 트랜스파일레이션을 활용한 Circuit 최적화

• 실제 양자 하드웨어에 자동 연결

• 최적의 양자 Backend 분석 및 선택

• 양자 Circuit 실행 및 작업 상태 추적

무엇이 포함되어 있나요?

다음 MCP 서버들을 사용할 수 있습니다:

Qiskit MCP 서버

로컬 개발을 위한 핵심 양자 컴퓨팅 기능을 제공합니다. 이 서버를 통해 AI 어시스턴트는 양자 Circuit을 생성, 조작, 트랜스파일하고, OpenQASM 3 및 QPY와 같은 형식으로 직렬화할 수 있습니다.

Qiskit Runtime MCP 서버

IBM Quantum Compute Service를 통해 IBM Quantum 클라우드 서비스에 대한 접근을 제공합니다. 이를 통해 AI 어시스턴트가 양자 Backend와 상호작용하고, 작업을 제출하며, 결과를 가져올 수 있습니다.

Qiskit Docs MCP 서버

Qiskit 문서 전체 생태계(SDK 모듈 문서, 구현 가이드, 모범 사례 포함)에 대한 접근을 AI 어시스턴트에게 제공합니다. 이 서버를 통해 인증 없이도 Qiskit 문서 전반에 걸쳐 지능형 검색과 조회를 수행할 수 있습니다.

Qiskit IBM Transpiler MCP 서버

AI 기반 Transpiler 패스를 통해 AI 기반 Circuit 최적화를 제공합니다. 이 서버를 통해 AI 어시스턴트는 고급 라우팅 및 최적화 알고리즘을 사용하여 양자 Circuit을 최적화할 수 있습니다.

커뮤니티 서버

다음의 커뮤니티 기여 MCP 서버도 사용할 수 있습니다:

Qiskit Gym MCP 서버

qiskit-gym 라이브러리를 사용하여 양자 Circuit 합성을 위한 강화 학습 기능을 제공합니다. 이 서버를 통해 AI 어시스턴트는 양자 Circuit 트랜스파일레이션 및 합성을 위한 RL 기반 최적화 기법을 활용할 수 있습니다.

Qiskit MCP 서버 설치

Qiskit MCP 서버를 사용하려면 다음이 필요합니다:

• Python 3.10 이상 (3.11+ 권장)

• IBM Quantum 계정 및 API 토큰 (안내는 IBM Cloud® 계정 설정 참고)

터미널에서 다음 명령을 실행하여 사용 가능한 모든 Qiskit MCP 서버를 설치합니다:

pip install qiskit-mcp-servers[all]

개별 MCP 서버를 설치할 수도 있습니다:

pip install qiskit-mcp-server
pip install qiskit-code-assistant-mcp-server
pip install qiskit-ibm-runtime-mcp-server
pip install qiskit-docs-mcp-server
pip install qiskit-ibm-transpiler-mcp-server
pip install qiskit-gym-mcp-server

Qiskit MCP 서버 구성

환경 변수 설정

인증을 위한 필수 환경 변수를 설정합니다. Qiskit MCP 서버와 Qiskit Docs MCP 서버는 인증이 필요하지 않습니다.

IBM Quantum Compute Service, 또는 Qiskit IBM Transpiler MCP 서버의 경우:

export QISKIT_IBM_TOKEN="<your_token>"

API 토큰은 IBM Quantum 계정 설정에서 확인할 수 있습니다.

MCP 클라이언트 구성

MCP 호환 클라이언트(예: Claude Desktop, Cursor, 또는 기타 AI 도구)가 Qiskit MCP 서버를 사용하도록 구성할 수 있습니다. 정확한 구성 방법은 클라이언트에 따라 다릅니다. 예를 들어, MCP 클라이언트 구성 파일은 다음과 같이 작성할 수 있습니다:

{
  "mcpServers": {
    "qiskit": {
      "command": "qiskit-mcp-server"
    },
    "qiskit-ibm-runtime": {
      "command": "qiskit-ibm-runtime-mcp-server"
    },
    "qiskit-code-assistant": {
      "command": "qiskit-code-assistant-mcp-server"
    },
    "qiskit-docs": {
      "command": "qiskit-docs-mcp-server"
    },
    "qiskit-ibm-transpiler": {
      "command": "qiskit-ibm-transpiler-mcp-server"
    },
    "qiskit-gym": {
      "command": "qiskit-gym-mcp-server"
    }
  }
}

구체적인 구성 방법은 사용하는 MCP 클라이언트의 문서를 참고하세요.

MCP 서버 테스트

MCP Inspector를 사용하여 MCP 서버를 대화형으로 테스트할 수 있습니다:

# Test the Qiskit MCP Server
npx @modelcontextprotocol/inspector qiskit-mcp-server

# Test the Qiskit Runtime MCP Server
npx @modelcontextprotocol/inspector qiskit-ibm-runtime-mcp-server

# Test the Qiskit Docs MCP Server
npx @modelcontextprotocol/inspector qiskit-docs-mcp-server

# Test the Qiskit IBM Transpiler MCP Server
npx @modelcontextprotocol/inspector qiskit-ibm-transpiler-mcp-server

# Test the Qiskit Gym MCP Server
npx @modelcontextprotocol/inspector qiskit-gym-mcp-server

다음 단계

권장 사항

• 자세한 문서와 API 지원 범위, 예시는 Qiskit MCP 서버 GitHub 저장소에서 확인하세요.

• AI 기반 Circuit 최적화 기능에 대한 자세한 내용은 AI 기반 Transpiler 패스를 참고하세요.

• 아직 설정하지 않았다면 IBM Quantum 계정을 설정하세요.

• MCP에 대한 자세한 내용은 Model Context Protocol 문서를 참고하세요.