Qiskit MCP 서버

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

참고

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

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

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

• 양자 Circuit 생성, 조작 및 Transpiler 처리
• 신뢰할 수 있는 소스에서 직접 양자 컴퓨팅 질문에 답변
• 문맥 인식을 통한 양자 코드 생성
• AI 기반 Transpiler를 활용한 Circuit 최적화
• 실제 양자 하드웨어에 자동 연결
• 최적의 양자 Backend 분석 및 선택
• 양자 Circuit 실행 및 작업 상태 추적

무엇이 포함되어 있나요?

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

Qiskit MCP 서버

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

Qiskit Code Assistant MCP 서버

Qiskit Code Assistant를 통해 지능형 양자 코드 완성 및 지원 기능을 제공합니다. 이 서버는 Qiskit Code Assistant 기능을 MCP 호환 AI 도구에 직접 통합합니다.

Qiskit Code Assistant의 다른 기능과 마찬가지로, 이 MCP 서버는 IBM Quantum Platform에 등록된 IBM Quantum Premium Plan 사용자에게만 작동합니다.

Qiskit Runtime MCP 서버

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

Qiskit IBM Transpiler MCP 서버

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

커뮤니티 서버

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

Qiskit Gym MCP 서버

qiskit-gym 라이브러리를 사용하여 양자 Circuit 합성을 위한 강화 학습 기능을 제공합니다. 이 서버를 통해 AI 어시스턴트는 양자 Circuit Transpiler 처리 및 합성을 위한 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-ibm-transpiler-mcp-server
pip install qiskit-gym-mcp-server

Qiskit MCP 서버 구성

환경 변수 설정

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

Qiskit Runtime, Qiskit Code Assistant, 또는 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-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 Code Assistant MCP Server
npx @modelcontextprotocol/inspector qiskit-code-assistant-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 코드 완성 기능을 이해하기 위해 Qiskit Code Assistant에 대해 알아보세요.
• AI 기반 Circuit 최적화 기능을 이해하기 위해 AI 기반 Transpiler 패스에 대해 알아보세요.
• 아직 설정하지 않았다면 IBM Quantum 계정을 설정하세요.
• MCP에 대해 더 알아보기 위해 Model Context Protocol 문서를 살펴보세요.