Qiskit MCP 服务器

一组**模型上下文协议（MCP）**服务器，提供AI助手、大语言模型（LLMs）和代理无缝访问IBM量子服务及Qiskit库，用于量子计算开发和研究。

🌟 这是什么？

此仓库包含生产就绪的MCP服务器，使AI系统能够通过Qiskit与量子计算资源进行交互。无需手动配置量子后端、编写样板代码或管理IBM量子账户，AI助手现在可以：

• 🤖 生成智能量子代码，具有上下文感知建议
• 🔌 自动连接到真实的量子硬件
• 📊 分析量子后端并找到最优资源
• 🚀 执行量子电路并监控作业状态
• 💡 提供量子计算支持，具备专业知识

🛠️ 可用服务器

🧠 Qiskit 代码助手 MCP 服务器

智能量子代码补全和辅助

提供对IBM的Qiskit代码助手AI的访问，以实现智能量子编程

📁 目录：./qiskit-code-assistant-mcp-server/

---

⚙️ Qiskit IBM 运行时 MCP 服务器

完全访问IBM量子云服务

通过Qiskit IBM运行时全面接口访问IBM量子硬件

📁 目录：./qiskit-ibm-runtime-mcp-server/

🚀 快速开始

预备条件

• Python 3.10+（推荐3.11+）
• uv 包管理器（最快的Python包管理器）
• IBM量子账户和API令牌
• Qiskit代码助手访问（对于代码助手服务器）

安装与使用

每个服务器设计为独立运行。选择你需要的服务器：

🧠 Qiskit 代码助手服务器

cd qiskit-code-assistant-mcp-server
uv run qiskit-code-assistant-mcp-server

⚙️ IBM 运行时服务器

cd qiskit-ibm-runtime-mcp-server
uv run qiskit--ibm-runtime-mcp-server

🔧 配置

环境变量

# 对于IBM运行时服务器
export QISKIT_IBM_TOKEN="your_ibm_quantum_token_here"

# 对于代码助手服务器  
export QISKIT_IBM_TOKEN="your_ibm_quantum_token_here"
export QCA_TOOL_API_BASE="https://qiskit-code-assistant.quantum.ibm.com"

使用MCP客户端

两个服务器都兼容任何MCP客户端。使用MCP Inspector进行交互测试：

# 测试代码助手服务器
npx @modelcontextprotocol/inspector uv run qiskit-code-assistant-mcp-server

# 测试IBM运行时服务器
npx @modelcontextprotocol/inspector uv run qiskit-ibm-runtime-mcp-server

🏗️ 架构与设计

🎯 统一设计原则

两个服务器遵循一致的生产就绪架构：

• 🔄 异步优先：使用FastMCP构建高性能异步操作
• 🧪 测试驱动：覆盖率超过65%的全面测试套件
• 🛡️ 类型安全：完整的mypy类型检查和验证
• 📦 现代打包：标准pyproject.toml和hatchling构建系统
• 🔧 开发者友好：自动化格式化（ruff）、linting和CI/CD

🔌 MCP协议支持

两个服务器实现了完整的模型上下文协议规范：

• 🛠️ 工具：执行量子操作（代码补全、作业提交、后端查询）
• 📚 资源：访问量子数据（服务状态、后端信息、模型细节）
• ⚡ 实时：异步操作以实现响应式AI交互
• 🔒 安全：适当的认证和错误处理

🧪 开发

🏃‍♂️ 运行测试

# 运行代码助手服务器的测试
cd qiskit-code-assistant-mcp-server
./run_tests.sh

# 运行IBM运行时服务器的测试  
cd qiskit-ibm-runtime-mcp-server
./run_tests.sh

🔍 代码质量

两个服务器保持高标准的代码质量：

• ✅ linting：ruff check 和 ruff format
• 🛡️ 类型检查：mypy src/
• 🧪 测试：具有异步支持和覆盖率报告的pytest
• 🚀 CI/CD：GitHub Actions进行自动化测试

📖 资源与文档

🔗 关键链接

• 模型上下文协议 - 了解MCP
• Qiskit IBM运行时 - 量子云服务
• Qiskit代码助手 - AI代码辅助
• MCP Inspector - 交互测试工具
• FastMCP - 高性能MCP框架

📄 许可证

本项目根据Apache许可证2.0版授权。