内容
<div align="center">
# 微型电容-MCP
**ИИ-агент строит, считает и рисует аналоговые схемы в Micro-Cap 12.**
[](https://github.com/monoxide-xen/microcap-mcp/actions/workflows/tests.yml)
[](LICENSE)
[](https://www.python.org/)
[](#安装)
[](https://modelcontextprotocol.io/)
**中文** · [English](README.en.md)
<img src="docs/assets/hero-ce.svg" width="410" alt="生成的共射极放大器，1:1绘制，与Micro-Cap相同，叠加了工作点"> <img src="docs/assets/plot-ac.jpg" width="410" alt="由Micro-Cap计算的频率响应">
<sub>电路由服务器生成（1:1与Micro-Cap相同，带有工作点）· 图形由Micro-Cap计算</sub>
</div>
---
通过Micro-Cap的批处理模式（`MC12 @batch.bat`）工作——无头，无GUI自动化，无程序修改。
## 功能
🔧 **构建电路** — 8种基本放大器生成器（共射极、跟随器、MOSFET、差分对、电流镜、共源极、运算放大器、RLC）带有自动偏置。每个都经过理论验证：增益、工作点、谐振。
📊 **计算** — 瞬态/交流/直流/失真/稳定性分析，工作点，扫描。综合输出为 `{re, im}`，求解器诊断。
🎨 **绘图** — 将 `.CIR` 文件渲染为SVG，**与Micro-Cap 1:1**：使用Micro-Cap的原生符号，网格，旋转和反射，标签布局。叠加工作点电压。Micro-Cap的批处理模式不具备此功能，但服务器可以。
<div align="center">
<img src="docs/assets/diffpair.svg" height="200" alt="差分对"> <img src="docs/assets/cascode.svg" height="200" alt="共源极"> <img src="docs/assets/opamp.svg" height="200" alt="运算放大器电路图">
</div>
## 安装
需要Windows，Python 3.11+，以及已安装的 [Micro-Cap 12](https://spectrum-soft.com/) （免费版本）。无需克隆仓库，只需在MCP客户端中指定，`uvx` 就会自动下载软件包：
```jsonc
{
"mcpServers": {
"microcap": {
"command": "uvx",
"args": ["microcap-mcp"],
"env": { "MICROCAP_HOME": "E:/Tools/MC12" } // 如果自动搜索未找到，请指定
}
}
}
```
驱动程序会自动在常见位置搜索Micro-Cap；如果Micro-Cap安装在非标准位置，请在`MICROCAP_HOME`中指定路径。
<details>
<summary>从源代码构建</summary>
```bash
git clone https://github.com/monoxide-xen/microcap-mcp
cd microcap-mcp
uv sync
```
```jsonc
{
"mcpServers": {
"microcap": {
"command": "uv",
"args": ["--directory", "C:/path/to/microcap-mcp", "run", "microcap-mcp"]
}
}
}
```
</details>
## 工具
| 工具 | 功能 |
|---|---|
| `simulate` · `sweep` · `plot` | 计算SPICE网表，扫描 `.DEFINE`，生成JPEG图像 |
| `generate_transistor_amplifier` · `_emitter_follower` · `_mosfet_amplifier` | 晶体管/MOSFET放大器，自动偏置到电源中间 |
| `generate_differential_pair` · `_current_mirror` · `_cascode` · `_amplifier` | 差分对，电流镜，共源极，运算放大器 |
| `generate_schematic` | 构建源+R/C/L串并联电路（RC/RL/RLC，分压器，环路） |
| `simulate_schematic` · `plot_schematic` | 计算/绘制任意 `.CIR` 文件 |
| `draw_schematic` · `annotate_schematic` | 将 `.CIR` 文件渲染为SVG（与Micro-Cap 1:1），在电路图上叠加工作点 |
| `simulate_example` · `search_examples` · `get_example` · `describe_example` · `list_domains` | ~490个Micro-Cap自带示例电路：搜索，获取，分析 |
此外，还有 **资源** `microcap://guide` 和 `microcap://domains`，以及 **提示** `analyse_circuit`，以确保代理不会默默地覆盖Micro-Cap的结果。
## 测试
```bash
uv run pytest # 138个不依赖Micro-Cap的单元测试；+30个依赖物理的集成测试（需要MC）
```
如果没有Micro-Cap，集成测试将被跳过——CI仍然会显示为绿色。
## 技术细节
- [Micro-Cap的特殊性](docs/micro-cap-notes.md) — 文档中未提及的行为（有时与文档相矛盾）。
- `eval/harness.py` — 运行所有~490个自带示例电路，并按原因分类失败结果（目前成功率88%）。
## 许可证
[MIT](LICENSE) 许可证适用于本仓库的代码。Micro-Cap 12归Spectrum Software所有——未包含，未重新分发，未修改：使用其文档化的命令行接口。
