    
从任何兼容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开源。独立于
铜山科技(商标免责声明如下)。
免责声明: 本项目不隶属于、认可或 由铜山科技赞助。“铜山”是商标 铜山技术公司。这是一个独立的开源项目。
______________________________________________________________________
快速开始
安装
pip install coppermountain-vna-mcp或来源:
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
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客户端)
{
"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上运行。通过命令行启用套接字服务器:
:: 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端口反射):
vna_calibration_start(method="SOL")vna_calibration_measure_standard(standard="SHORT", port_num=1)vna_calibration_measure_standard(standard="OPEN", port_num=1)vna_calibration_measure_standard(standard="LOAD", port_num=1)vna_calibration_apply()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 |
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 用于迭代匹配优化。
使用以下组件安装捆绑包:
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 |
______________________________________________________________________
贡献
欢迎捐款。
- 选择一个 .
- 分叉+分支(
feature/your-thing或fix/your-bug). - 运行本地检查套件:
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代理而构建。
