从任何兼容MCP的AI客户端驱动铜山矢量网络分析仪。
TCP/IP SCPI在线传输——45个工具,涵盖扫描、校准、测量和导出。
快速开始 ·
工具 ·
工作流 ·
文档
什么是铜山vna-mcp?
copper-mountain-vna-mcp 是一个 模型上下文协议
公开铜山VNA-RVNA、TRVNA、S2VNA或S4VNA系列的服务器
--任何支持MCP的AI助手。服务器将原始TCP/IP SCPI与
铜山软件套接字服务器(默认端口 5025),然后表面
扫描配置、校准、S参数捕获、标记数学和
Touchstone导出为普通MCP工具。
从克劳德桌面、克劳德代码、VS代码副本或任何其他MCP驱动
客户。SCPI是在服务器端生成的,因此AI代理永远不需要知道
底层命令集——它只是调用 vna_configure_sweep, vna_trigger_sweep,
vna_get_s_parameter 并返回结构化数据。
什么 copper-mountain-vna-mcp 做得很好:
- 🤖 通过MCP实现AI原生。 头等舱 模型上下文协议
配备45个工具的服务器。任何Claude/LLM代理都可以驾驶它。 - 🐍 Python+MCP曲面。 导入
coppermountain_vna_mcp对于直接驾驶员访问,
或者作为用于AI代理自动化的MCP服务器运行。 - ⚡ 直接TCP/IP SCPI。 没有VISA依赖,没有专有中间件——只是
asyncio套接字直接连接到铜山软件套接字服务器。 - ✅ 针对4个VNA家族进行了验证。 RVNA(S11)、TRVNA(S11/S21),
S2VNA(全2端口)、S4VNA(满4×4)。 - 🔒 AGPL-3.0或更高版本。 网络copyleft开源。独立于
铜山科技(商标免责声明如下)。
> 免责声明: 本项目不隶属于、认可或
> 由铜山科技赞助。“铜山”是商标
> 铜山技术公司。这是一个独立的开源项目。
快速开始
安装```bash
pip install coppermountain-vna-mcp
或来源:```bash
git clone https://github.com/RFingAdam/copper-mountain-vna-mcp.git
cd copper-mountain-vna-mcp
pip install -e ".[dev]"
支持的仪器
| 系列 | 描述 | 示例模型 | S参数 |
|---|---|---|---|
| RVNA | 1端口反射计 | R54,R60 | S11 |
| TRVNA | 2端口1路 | TR1300 | S11、S21 |
| S2VNA | 2端口全反转 | M5090,平面804/1 | S11、S12、S21、S22 |
| S4VNA | 4端口满 | S5048 | 满4×4矩阵 |
两个表面,相同的答案
python```python
import asyncio
from coppermountain_vna_mcp.driver import CopperMountainVNADriver
from coppermountain_vna_mcp.models import SParameter, SweepConfig
async def main():
async with CopperMountainVNADriver("127.0.0.1", 5025) as vna:
await vna.configure_sweep(SweepConfig(
start_freq_hz=1e9, stop_freq_hz=2e9,
num_points=201, if_bandwidth_hz=1000, power_dbm=0,
))
await vna.trigger_sweep()
data = await vna.get_s_parameter_data(SParameter.S11)
marker = await vna.marker_search_min()
print(f"Best match: {marker.frequency_hz/1e9:.3f} GHz @ {marker.magnitude_db:.1f} dB")
asyncio.run(main())
**MCP(克劳德桌面、克劳德代码、任何MCP客户端)**```json
{
"mcpServers": {
"copper-mountain-vna": {
"command": "python",
"args": ["-m", "coppermountain_vna_mcp"],
"env": {
"VNA_DEFAULT_HOST": "127.0.0.1",
"VNA_DEFAULT_PORT": "5025"
}
}
}
}
然后用简单的英语问你的助手:
> “连接到127.0.0.1上的VNA,在201个点上扫1-2 GHz,并告诉我S11在哪里最匹配。”
代理人将致电 vna_connect, vna_configure_sweep, vna_trigger_sweep,
和 vna_marker_search_min 并按顺序报告结果。
启动VNA软件套接字服务器
VNA软件在Windows上运行。通过命令行启用套接字服务器:```cmd
:: S2VNA / S4VNA
S2VNA.exe /SocketServer:on /SocketPort:5025 /visible:on
:: RVNA / TRVNA
RVNA.exe EnableSocket:5025
或者在GUI中: `System > Socket Server > Enable`.
### 配置
通过环境变量进行配置或 `.env` 文件:
|变量|默认值|描述|
| -------- | ------- | ----------- |
| `VNA_DEFAULT_HOST` | `127.0.0.1` |VNA软件主机IP|
| `VNA_DEFAULT_PORT` | `5025` |套接字服务器端口|
| `VNA_CONNECTION_TIMEOUT` | `5.0` |TCP连接超时|
| `VNA_COMMAND_TIMEOUT` | `30.0` |SCPI命令超时|
| `VNA_MAX_POWER_DBM` | `10` |最大输出功率|
| `VNA_MIN_POWER_DBM` | `-55` |最小输出功率|
| `VNA_MAX_FREQUENCY_HZ` | `20e9` |上扫线|
| `VNA_MAX_POINTS` | `10001` |最大扫描点|
______________________________________________________________________
## 工具
45个MCP工具,分组:
|组|工具|
| ----- | ----- |
| **连接** | `vna_discover`, `vna_connect`, `vna_disconnect`, `vna_identify`, `vna_get_status` |
| **配置** | `vna_configure_sweep`, `vna_set_center_span`, `vna_set_averaging`, `vna_set_port_power`, `vna_output_on`, `vna_output_off` |
| **测量** | `vna_trigger_sweep`, `vna_get_s_parameter`, `vna_measure_return_loss`, `vna_measure_vswr`, `vna_measure_insertion_loss` |
| **标记** | `vna_set_marker`, `vna_get_marker`, `vna_marker_search_min`, `vna_marker_search_max`, `vna_marker_bandwidth` |
| **校准** | `vna_calibration_status`, `vna_calibration_start`, `vna_calibration_measure_standard`, `vna_calibration_apply`, `vna_correction_on`, `vna_correction_off` |
| **出口** | `vna_save_touchstone`, `vna_save_screenshot` |
| **模板** | `vna_list_templates`, `vna_load_template`, `vna_apply_template` |
| **国家** | `vna_save_state`, `vna_load_state`, `vna_get_full_state` |
| **限制** | `vna_define_limit`, `vna_check_limits`, `vna_list_limits`, `vna_clear_limits` |
| **软件** | `vna_software_show`, `vna_software_hide` |
| **低水平SCPI** | `vna_scpi_send`, `vna_scpi_query`, `vna_reset`, `vna_preset` |
完整的工具参考 `docs/tools.md`.
______________________________________________________________________
## 校准
标准cal流作为离散工具公开,因此代理可以逐步执行它们
一步一步。
**SOL(1端口反射):**
1. `vna_calibration_start(method="SOL")`
1. `vna_calibration_measure_standard(standard="SHORT", port_num=1)`
1. `vna_calibration_measure_standard(standard="OPEN", port_num=1)`
1. `vna_calibration_measure_standard(standard="LOAD", port_num=1)`
1. `vna_calibration_apply()`
1. `vna_correction_on()`
**SOLT(2端口满):** 两个端口都短路/打开/加载,然后 `THRU` 之间
然后申请。
校准是频率特定的——当扫描范围
变化很大。
______________________________________________________________________
## 测量模板
为常见DUT类预先配置扫描+标记+跟踪设置。加载方式
名称与 `vna_load_template`那么 `vna_apply_template` 向VNA推进。
|类别|示例|
| -------- | -------- |
| **天线——WiFi/BLE** | `antenna_wifi_24ghz`, `antenna_ble_24ghz`, `antenna_wifi_5ghz`, `antenna_wifi_5ghz_unii1/unii3`, `antenna_wifi_6ghz`, `antenna_wifi_dual_band`, `antenna_wifi_tri_band` |
| **天线——MIMO** | `antenna_mimo_wifi_24ghz`, `antenna_mimo_wifi_5ghz`, `antenna_mimo_wifi_dual_band`, `antenna_mimo_cellular` |
| **天线-ISM/蜂窝/GNSS** | `antenna_ism_us915`, `antenna_ism_eu868`, `antenna_ism_worldwide`, `antenna_cellular`, `antenna_gps_l1`, `antenna_gnss_dual_band`, `antenna_nfc` |
| **天线-UWB** | `antenna_uwb_channel_5`, `antenna_uwb_channel_9`, `antenna_uwb_full_band` |
| **电缆** | `cable_dc_2_4ghz`, `cable_dc_8_5ghz` |
| **过滤器** | `filter_wifi_24ghz`, `filter_wifi_5ghz`, `filter_ism_915mhz`, `filter_gps_l1`, `filter_bandpass_custom`, `filter_lowpass_custom` |
```python
await vna.load_template("antenna_wifi_5ghz")
await vna.apply_template()
# Custom filter — provide parameters at load time
await vna.load_template("filter_bandpass_custom",
center_freq_hz=1.5e9, bandwidth_hz=100e6)
await vna.apply_template()
工作流
copper-mountain-vna-mcp 符合以下条件 eng-mcp套房
工作流捆绑包:
lab-automation--搭配mcp-rs-spectrum-analyzer,mcp-rs-siggen,
和mcp-rs-cmw500用于端到端射频台架测试工作流程,由
单代理会话。antenna-tuning--将回波损耗/VSR迹线馈入mcp-nec2-antenna
或mcp-openems用于迭代匹配优化。
使用以下组件安装捆绑包:```bash
eng-mcp-suite install --workflow lab-automation
______________________________________________________________________
## 文档
- 📘 **快速开始** --通过第一次调用进行安装。
- 🛠️ **工具参考** --每一个MCP工具,每一个论点。
- 📐 **使用示例** --一个实用的端到端S11演练。
- 🏗️ **建筑** --这个MCP如何适应eng-MCP套件。
- 📝 **更新日志**
______________________________________________________________________
## eng-mcp套件的一部分
此MCP服务器是
部分 eng-mcp套房 --一个开放
用于RF/EMC/PCB/信号完整性工程的MCP服务器保护伞
进入 `lab-automation` 工作流捆绑包
`eng-mcp-suite install --workflow lab-automation`.
|域|兄弟姐妹MCP|
| ------------------------- | ---------------------------------------------------------------------------- |
| **射频/传输线** | 线锻造厂 |
| **EMC法规** | mcp电磁兼容性法规 |
| **电磁模拟** |mcp-nec2-antenna|
| **图表** | 绘图工程mcp |
| **实验室装备** |铜山vna mcp· mcp-rs频谱分析仪 · mcp-rs-siggen · mcp-rs-cmw500 |
______________________________________________________________________
## 贡献
欢迎捐款。
1. 选择一个 GitHub问题.
1. 分叉+分支(`feature/your-thing` 或 `fix/your-bug`).
1. 运行本地检查套件:```bash
ruff check . && mypy src/coppermountain_vna_mcp
pytest --cov=coppermountain_vna_mcp
- 打开PR——链接问题,请求审核。
许可证
AGPL-3.0或更高版本版权所有2025-2026亚当·恩格尔布雷希特
(RFingAdam)。继承自v0.3.0中的Apache-2.0,以与
eng-mcp套件工具包全AGPL移动。
致谢
- 铜山科技 --用于记录所使用的SCPI命令集
通过RVNA/TRVNA/S2VNA/S4VNA软件。 - MCP工作组 --对于 模型上下文协议
规范。
部分 eng-mcp套房 --专为RF工程师、PCB设计师、EMC实验室和AI代理而构建。
