使用说明
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_KEY
3.安装依赖项
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
4.配置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。
