ngspice MCP server

ngspice mcp服务器

用于ngspice电路仿真的模型上下文协议（MCP）服务器

特性

• 提供用于运行ngspice模拟的MCP工具
• 用于模拟控制的REST API接口
• 支持参数化电路仿真
• 以JSON格式返回模拟结果

安装指南（仅限Linux）

1. 安装ngspice（模拟后端需要）：

   sudo apt-get install ngspice  # For Debian/Ubuntu systems

1. 确保已安装Python 3.8+（请参阅.Python版本文件）并安装uv工具：

   pip install uv

1. 创建并激活虚拟环境：

   uv venv .venv
   source .venv/bin/activate  # Linux/macOS

1. 使用不同的方法安装依赖关系：

- 紫外线直接安装：

     uv pip install -e .

- 使用uv构建，然后安装：

     uv build && pip install dist/ngspice_mcp_server-${version}-py3-none-any.whl
     # or uv build && pip install dist/ngspice_mcp_server-${version}.tar.gz

- 传统管道安装：

     pip install -e .

用法

启动服务器

运行服务器的不同方式：

• 使用uv运行：

  uv run ngspice-mcp-server

• 使用uvx（需要安装uvx）：

  uvx --from https://github.com/abelzhao/ngspice_mcp_server.git ngspice-mcp-server

NPX配置

{
  "mcpServers": {
    "ngspice-mcp-server": {
      "command": "uvx",
      "args": [
        "http://${server_ip}:4044/mcp/"
      ]
    }
  }
}

配置选项

可以在中修改服务器配置 src/ngspice-mcp-server/server.py:

• 端口号

开发指南

ngspice mcp服务器项目结构

.
├── .gitignore
├── .python-version
├── high_pass_filter.cir         # Example circuit file
├── pyproject.toml              # Python project configuration
├── README.md                   # English documentation
├── README.zh-CN.md             # Chinese documentation
├── uv.lock                     # UV dependency lock file
├── build/                      # Build directory
└── src/                        # Source code directory
    └── ngspice_mcp_server/     # Main package source
        ├── __init__.py         # Package initialization
        ├── __main__.py         # CLI entry point
        ├── server.py           # MCP server implementation
        └── simulate.py         # Simulation logic

文件描述

• high_pass_filter.cir：ngspice仿真演示的示例电路文件
• src/ngspice_mcp_server/server.py：包含MCP服务器实现和REST API接口
• src/ngspice_mcp_server/simulate.py：包含ngspice模拟逻辑和结果处理
• pyproject.toml：定义Python包元数据、依赖关系和构建配置

测试

运行测试套件：

pytest

许可证

MIT许可证

特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：

上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。

软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。