内容
# QSpice MCP 服务器
一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，用于 [QSpice](https://www.qorvo.com/design-hub/design-tools/interactive/qspice) 电路模拟器。AI 助手使用它来检查和编辑 `.qsch` 示意图，运行模拟，读取波形，并通过稳定的 JSON 工具导出结果。
## 安装
**要求：** Windows，Python **≥ 3.11** （在 3.11 和 3.12 上测试过），以及 QSpice（`QSPICE64.exe`）。
```bash
git clone https://github.com/kh6570/HAbedini-qspice-mcp.git
cd HAbedini-qspice-mcp
python -m venv .venv && .venv\Scripts\activate # Windows
pip install -e .
cp .env.example .env # 设置 QSPICE_EXE 为 QSPICE64.exe
qspice-mcp --describe # 健康检查
```
可选额外功能： `[后端]` （更丰富的示意图/原始集成）， `[遥测]` （OpenTelemetry 跨度）， `[开发]` （lint/test 工具）。
配置您的 MCP 客户端以启动 `qspice-mcp`，并设置 `QSPICE_EXE`，然后要求 AI 调用 `describe_server_capabilities`。完整的客户端设置和工作流程请参见 [用户指南](docs/user-guide.md)。
**AI / 首次 MCP 设置（Cursor 或 VS Code）：** 请参见 **[AGENTS.md](AGENTS.md)** — 运行 `scripts/setup_mcp.ps1` 以注册 **用户级** MCP（`%USERPROFILE%\.cursor\mcp.json` / VS Code 用户 `mcp.json`），重启 IDE，并使用 `scripts/verify_mcp.ps1` 验证。
**Buck 示例：** `list_workflow_instructions` → 跟踪 A `buck-converter-cpp` 或跟踪 B `buck-converter-cpp-catalog`，通过 `read_workflow_instruction`。
## 文档
**从这里开始：** **[用户指南](docs/user-guide.md)** — 客户端设置、工作流程和故障排除（安装在上面）。
| 文档 | 目的 |
| --- | --- |
| [用户指南](docs/user-guide.md) | 完整的使用文档 |
| [工具参考](docs/tool_reference.md) | MCP 工具合约 |
| [错误代码](docs/errors.md) | 稳定的客户端错误代码 |
| [安全](docs/security.md) | 威胁模型 |
| [C-Block 构建指南](docs/cblock_build_guide.md) | 编译 DLL 自定义设备 |
| [变更日志](CHANGELOG.md) | 发布历史 |
## 许可证
MIT
MCP 市场