UniQ MCP v4-量子电路合成服务器
简化版OpenRouter -无需本地GPU、隧道或HTTP服务器！
快速开始
1.获取OpenRouter API密钥
访问 openrouter.ai/keys 并创建API密钥。
2.配置环境
cd ~/Downloads/uniq-mcp-server
cp .env.example .env
# Edit .env and add your OPENROUTER_API_KEY3.安装依赖项
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt4.配置Manus MCP
添加到Manus MCP配置中：
{
"mcpServers": {
"uniq-mcp": {
"command": "python",
"args": ["/path/to/uniq-mcp-server/server.py"],
"env": {
"OPENROUTER_API_KEY": "your_key_here"
}
}
}
}5.在Manus中的使用
Using UniQ-MCP, synthesize a Bell state circuit______________________________________________________________________
可用工具
| 工具 | 说明 |
|---|---|
check_server_status | 检查服务器状态和配置 |
synthesize_circuit | 根据描述生成量子电路 |
synthesize_with_teacher | 教师用垫脚石指导综合 |
run_benchmark | 运行课程基准测试 |
list_benchmarks | 列出所有26个基准 |
execute_on_simulator | 在本地Qiskit模拟器上运行电路 |
execute_on_hardware | 在AWS Braket硬件上运行（如果可用） |
get_available_hardware | 列出可用的量子硬件 |
get_curriculum_problem | 获取下一个适应性课程问题 |
record_learning_attempt | 记录学习尝试以适应 |
get_curriculum_statistics | 获取课程学习统计数据 |
list_available_models | 显示可用的OpenRouter型号 |
generate_latex_table | 生成LaTeX结果表 |
______________________________________________________________________
建筑
┌─────────────────────────────────────────────────────────────┐
│ UniQ-MCP v4 │
├─────────────────────────────────────────────────────────────┤
│ │
│ Manus ◄──MCP STDIO──► UniQ-MCP Server │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ OpenRouter │ │
│ │ ┌───────────┐ │ │
│ │ │ DeepSeek │ │ ◄── Student (fast) │
│ │ │ Chat │ │ │
│ │ └───────────┘ │ │
│ │ ┌───────────┐ │ │
│ │ │ DeepSeek │ │ ◄── Teacher (reason) │
│ │ │ R1 │ │ │
│ │ └───────────┘ │ │
│ └─────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ Qiskit/Braket │ ◄── Execution │
│ └─────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘______________________________________________________________________
模型选项
您可以指定任何OpenRouter模型进行合成：
| 型号 | 用例 | 成本 |
|---|---|---|
deepseek/deepseek-chat | 快速合成（默认） | 低 |
deepseek/deepseek-reasoner | 教师推理 | 中等 |
anthropic/claude-3.5-sonnet | 高质量代码 | 中等 |
openai/gpt-4-turbo | 最高可靠性 | 高 |
meta-llama/llama-3.1-70b-instruct | 平衡良好 | 低 |
例子：
Using UniQ-MCP, synthesize a GHZ state using claude-3.5-sonnet______________________________________________________________________
基准测试
5个类别的26个问题：
| 类别 | 问题 |
|---|---|
| 基本闸门 | H、X、Y、Z、T门 |
| 量子位 | CNOT、CZ、SWAP、iSWAP |
| 纠缠 | 贝尔态、GHZ（3-5量子比特）、W态 |
| 算法 | QFT（2-4量子比特），Grover（2-3量子比特） |
| 高级 | 托夫利、弗雷金、电信、VQE ansatz |
______________________________________________________________________
v3有什么变化？
| v3（气闸） | v4（OpenRouter） |
|---|---|
| 需要本地RTX 2070 | 不需要本地GPU |
| 需要Cloudflare隧道 | 不需要隧道 |
| HTTP服务器包装器 | 直接MCP STDIO |
| 仅限Mistral 7B | 提供多种型号 |
| 复杂的启动脚本 | 简单的API密钥设置 |
| ~ 30秒延迟 | ~ 5-15秒延迟 |
______________________________________________________________________
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
OPENROUTER_API_KEY | 是 | 您的OpenRouter API密钥 |
UNIQ_DEFAULT_MODEL | 否 | 默认模式（deepseek/deepseek聊天） |
UNIQ_TEACHER_MODEL | 否 | 教师模型（deepseek/deepseek推理机） |
AWS_ACCESS_KEY_ID | 否 | 适用于AWS Braket硬件 |
AWS_SECRET_ACCESS_KEY | 否 | 适用于AWS Braket硬件 |
______________________________________________________________________
用法示例
基础合成
Using UniQ-MCP, create a Bell state circuit通过模型选择
Using UniQ-MCP, synthesize a 3-qubit QFT using gpt-4-turbo运行基准测试
Using UniQ-MCP, run the ghz_3 benchmark在模拟器上执行
Using UniQ-MCP, execute this Bell state on the simulator with 1000 shots生成LaTeX表
Using UniQ-MCP, run all entanglement benchmarks and generate a LaTeX table______________________________________________________________________
故障排除
“未设置OPENROUTER_API_KEY”
将API密钥添加到 .env 或通过MCP配置传递。
合成失败
- 检查您的OpenRouter余额
- 尝试其他型号
- 简化电路描述
模块导入错误
pip install mcp qiskit httpx chromadb______________________________________________________________________
许可证
麻省理工学院许可证-用于学术研究。
贡献
欢迎投稿！在GitHub上提交问题和PR。