香料服务
集成MCP服务器的电路仿真软件
版权所有(c)2025基思规则
SpiceService是一个全面的电路仿真应用程序,通过易于使用的Windows托盘应用程序和MCP(模型上下文协议)服务器集成提供强大的基于SPICE的电路分析。非常适合电路设计师、电子爱好者和人工智能驱动的开发工作流程。
快速安装
预构建的MSI安装程序可在 dist 目录:
- 位置:
dist\SpiceServiceTray.msi - 安装:双击要安装的MSI文件(每个用户安装,不需要管理员权限)
- 包含:托盘应用程序、MCP服务器和500多个SPICE组件库
特性
电路仿真
- 直流分析:工作点和电压/电流扫描
- 交流分析:带幅度和相位的频率响应(波特图)
- 瞬态分析:具有可定制波形的时域模拟
- 参数扫描:分析元件值范围内的电路行为
- 温度扫描:评估不同温度范围内的电路性能
- 噪声分析:电路噪声特性
- 阻抗分析:频率相关阻抗测量
构件库
- 500多个SPICE图书馆:KiCad Spice库中的综合组件数据库
- 组件搜索:快速搜索所有库文件
- 子电路支持:可重复使用的电路块,包括扬声器型号
- 演讲者数据库:Thiele扬声器设计小参数数据库
- 模型定义:支持二极管、BJT、MOSFET、JFET等
扬声器设计工具
- 扬声器搜索:通过Thiele Small参数(FS、QTS、VAS等)查找扬声器
- 外壳设计:计算最佳密封或通风箱设计
- 交叉兼容性:检查交叉设计的低音扬声器/高音扬声器兼容性
- 扬声器子电路:针对真实扬声器驱动程序的预构建SPICE模型
可视化
- 折线图:时域和直流扫描可视化
- 波特图:频率响应,幅度(dB)和相位(度)
- 条形图:操作点比较
- 散布图:自定义X-Y数据可视化
- 原理图渲染:视觉电路图(SVG格式)
- 导出格式:PNG和SVG输出
波形支持
- 正弦波:具有振幅、频率、相位和阻尼的交流信号
- 脉搏波:开关电路用数字方波脉冲
- PWL(分段线性):自定义电压/电流曲线
- SFFM/AM:射频电路的频率和幅度调制
MCP服务器集成
- JSON-RPC 2.0协议:标准MCP协议支持
- AI IDE集成:与Claude Desktop、Cursor AI、VS Code、Windsurf兼容
- 自动发现:在本地网络上自动发现服务器
- 网络接入:仅可配置本地主机或网络可访问模式
托盘应用
- 系统托盘集成:在后台安静地运行
- 自动启动:可选择在Windows登录时自动启动
- 电路管理:查看、创建和管理多个回路
- 电路导出:将电路导出为SPICE网表
- 日志查看器:内置调试和监控
- IDE配置:一键设置AI驱动的IDE
安装
选项1:MSI安装程序(推荐)
- 下载
dist\SpiceServiceTray.msi - 双击安装(不需要管理员权限)
- 应用程序安装到:
%LocalAppData%\SpiceService\Tray\ - “开始”菜单快捷方式是自动创建的
选项2:从源代码构建
先决条件:
- .NET SDK 8.0或更高版本
- Windows(托盘应用程序需要)
- WiX工具集v3.11+(用于建筑安装程序)
构建步骤:
# Build entire solution
dotnet build SpiceService.sln --configuration Release
# Build and run tray application
dotnet run --project SpiceSharp.Api.Tray/SpiceSharp.Api.Tray.csproj构建安装程序:
cd SpiceServiceTray.Installer
.\build-installer.ps1用法
启动应用程序
安装后,SpiceService会在系统托盘中自动运行。在Windows系统托盘中查找SpiceService图标。
右键单击托盘图标 访问:
- 状态:查看当前服务器状态
- 登录时自动启动:启用/禁用自动启动
- 网络可访问:切换网络可见性
- 配置IDE集成。..:设置AI IDE连接
- 列出电路。..:查看和管理电路
- 输出电路。..:导出为SPICE网表
- 查看日志。..:打开日志查看器
- 关于。..:应用程序信息
- 退出:关闭应用程序
与AI IDE一起使用
SpiceService与AI驱动的开发环境无缝集成:
- 启动Spice服务:确保托盘应用程序正在运行
- 配置IDE:右键单击托盘图标→ 配置IDE集成。..
- 选择IDE:检查要配置的IDE
- 应用:单击 应用 配置
- 重启IDE:重新启动IDE以进行连接
支持的IDE:
- 克劳德桌面版
- 光标AI
- VS代码(带MCP扩展名)
- 帆板运动
基本电路仿真工作流程
1.创建电路
{
"method": "tools/call",
"params": {
"name": "create_circuit",
"arguments": {
"circuit_id": "my_circuit",
"description": "My first circuit"
}
}
}2.添加组件
{
"method": "tools/call",
"params": {
"name": "add_component",
"arguments": {
"circuit_id": "my_circuit",
"name": "V1",
"component_type": "voltage_source",
"nodes": ["input", "0"],
"value": 5.0,
"parameters": {"ac": 1}
}
}
}3.运行分析
{
"method": "tools/call",
"params": {
"name": "run_ac_analysis",
"arguments": {
"circuit_id": "my_circuit",
"start_frequency": 20,
"stop_frequency": 20000,
"number_of_points": 100,
"signals": ["v(input)"]
}
}
}4.可视化结果
{
"method": "tools/call",
"params": {
"name": "plot_results",
"arguments": {
"circuit_id": "my_circuit",
"signals": ["v(input)"],
"plot_type": "bode",
"image_format": "png"
}
}
}使用子电路
子电路允许您使用预构建的电路块,包括扬声器型号:
1.搜索子电路
{
"method": "tools/call",
"params": {
"name": "library_search",
"arguments": {
"query": "275_030",
"type": "subcircuit"
}
}
}2.在电路中添加子电路
{
"method": "tools/call",
"params": {
"name": "add_component",
"arguments": {
"circuit_id": "my_circuit",
"name": "Xspeaker",
"component_type": "subcircuit",
"model": "275_030",
"nodes": ["output", "0"]
}
}
}3.从网表导入
您还可以从SPICE网表导入包含子电路的完整电路:
{
"method": "tools/call",
"params": {
"name": "import_netlist",
"arguments": {
"circuit_name": "crossover",
"netlist": "V1 input 0 AC 1\nX1 input 0 275_030\n.end"
}
}
}扬声器设计工作流程
1.搜索演讲者
{
"method": "tools/call",
"params": {
"name": "search_speakers_by_parameters",
"arguments": {
"driver_type": ["tweeters"],
"diameter_min": 0.75,
"sensitivity_min": 88
}
}
}2.设计外壳
{
"method": "tools/call",
"params": {
"name": "calculate_enclosure_design",
"arguments": {
"model": "275_030",
"enclosure_type": "sealed",
"target_qtc": 0.707
}
}
}3.检查交叉兼容性
{
"method": "tools/call",
"params": {
"name": "check_crossover_compatibility",
"arguments": {
"woofer_model": "297_429",
"tweeter_model": "275_030",
"crossover_frequency": 2000,
"crossover_order": 2
}
}
}组件类型
被动元件
- 电阻器、电容器、电感器
- 互感器
来源
- 电压源(直流、交流、瞬态波形)
- 电流源
- 行为来源(数学表达式)
半导体
- 二极管(带定制型号)
- BJT(NPN/PNP)
- MOSFET(N沟道/P沟道)
- JFET(N沟道/P沟道)
- 开关(电压/电流控制)
受控源
- VCVS、VCCS、CCVS、CCCS(电压/电流控制源)
子电路
- 库文件中的可重用电路块
- 带Thiele Small参数的扬声器型号
- 自定义子电路定义
图书馆管理
图书馆位置
SpiceService自动搜索SPICE库文件(.lib)按照以下顺序:
- 用户库 (最高优先级):
Documents\SpiceService\libraries\ - 已安装的库:
libraries\可执行文件旁边的子目录 - 开发库:源目录
libraries\文件夹
添加自定义库
- 创建
Documents\SpiceService\libraries\目录 - 复制您的
.lib文件到此目录 - 重新启动SpiceService(库在启动时被索引)
图书馆搜索
搜索组件和子电路:
{
"method": "tools/call",
"params": {
"name": "library_search",
"arguments": {
"query": "2N2222",
"limit": 10
}
}
}网络配置
仅限本地主机(默认)
- MCP服务器只能从本地计算机访问
- 最安全的选择
- 建议用于单用户设置
网络可访问
- 可从网络上的其他设备访问MCP服务器
- 从托盘菜单启用: 网络可访问
- 需要重新启动应用程序
- 适用于远程IDE连接
发现服务
- 基于UDP的自动服务发现
- 在本地网络上广播服务器可用性
- 端口:19847(默认)
- 允许自动客户端连接,无需手动配置
故障排除
应用程序无法启动
- 检查另一个实例是否已在运行(只允许一个实例)
- 核实。NET 8.0桌面运行时已安装
- 检查系统托盘中的应用程序图标
- 从托盘菜单查看日志: 查看日志。..
MCP服务器不可访问
- 确保托盘应用程序正在运行
- 检查防火墙设置(默认端口8081)
- 验证托盘菜单中的网络可见性设置
- 检查日志中的连接错误
未找到子电路
- 验证库文件是否位于正确位置
- 检查库是否已编入索引(请参阅日志)
- 使用
reindex_libraries刷新索引的工具 - 确保子电路名称与库定义匹配
IDE集成问题
- 在配置IDE之前,确保SpiceService正在运行
- 配置后重新启动IDE
- 检查IDE特定的配置要求
- 验证
McpRemote.exe位于安装目录中
图书馆搜索不起作用
- 库在启动时被索引(可能需要几秒钟)
- 检查日志的索引状态
- 验证库文件是否为有效的SPICE格式
- 尝试
reindex_libraries刷新工具
项目结构
SpiceService/
├── SpiceSharp.Api.Core/ # Core simulation library
├── SpiceSharp.Api.Plot/ # Plotting and visualization
├── SpiceSharp.Api.Web/ # MCP server (HTTP/JSON-RPC)
├── SpiceSharp.Api.Tray/ # Windows tray application
├── McpRemote/ # IDE integration proxy
├── SpiceServiceTray.Installer/ # MSI installer
├── libraries/ # SPICE component libraries (500+ files)
└── dist/ # Build output (MSI installer)发展
从源头构建
# Build solution
dotnet build SpiceService.sln
# Run tests
dotnet test SpiceService.sln
# Run tray application
dotnet run --project SpiceSharp.Api.Tray
# Run MCP server standalone
dotnet run --project SpiceSharp.Api.Web运行测试
# All tests
dotnet test SpiceService.sln
# Specific test project
dotnet test SpiceSharp.Api.Core.Tests
dotnet test SpiceSharp.Api.Web.Tests其他资源
- MCP发现规范:
mcp_discovery_spec.md-服务发现协议 - IDE集成:
IDE-Integration-Configuration-Spec.md-IDE设置详细信息 - 安装程序构建:
SpiceServiceTray.Installer/BUILD_INSTRUCTIONS.md-MSI构建指南 - 行为来源:
BEHAVIORAL_SOURCES.md-表达式语法指南
许可证
版权所有(c)2025基思规则
本软件免费用于个人非商业用途。商业用途需要商业许可证。
第三方组件:
- SpiceSharp:电路仿真库(MIT/BSD风格许可证)
- KiCad香料库:组件库(GPL-3.0)
- OxyPlot:绘图库
- 网络列表Svg:示意图渲染
有关详细信息,请参阅单个组件许可证。
