analog-circuit-simulate-mcp-server

analog-circuit-simulate-mcp-server

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

功能

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

安装指南（仅限 Linux）

1. 安装 ngspice（仿真后端必需）：

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

2. 确保已安装 Python 3.8+（参见 .python-version 文件），并安装 uv 工具：

   pip install uv
   

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

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

4. 使用不同方法安装依赖项：

   • 使用 uv 直接安装：

     uv pip install -e .
     

   • 使用 uv 构建后安装：

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

   • 使用传统的 pip 安装：

     pip install -e .
     

使用方法

启动服务

启动服务的不同方式：

• 使用 uv run：

  uv run analog-circuit-simulate-mcp-server
  

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

  uvx --from https://github.com/abelzhao/analog_circuit_simulate_mcp_server.git analog-circuit-simulate-mcp-server
  

NPX 配置

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

配置选项

可以在 .venv 中修改服务配置：

• FASTMCP_PORT=4044
• FASTMCP_JSON_RESPONSE=True

开发指南

analog-circuit-simulate-mcp-server 项目结构

.
├── .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
    └── analog_circuit_simulate_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：用于电路仿真演示的示例电路文件
• src/analog_circuit_simulate_mcp_server/server.py：包含 MCP 服务实现和 REST API 接口
• src/analog_circuit_simulate_mcp_server/simulate.py：包含电路仿真逻辑和结果处理
• pyproject.toml：定义 Python 包元数据、依赖项和构建配置

NPX

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

测试

运行测试套件：

pytest

许可证

MIT 许可证

特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和／或销售本软件副本的权利，并允许获得本软件的人这样做，但须符合以下条件：

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

本软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权的保证。在任何情况下，无论是合同、侵权还是其他责任理论，作者或版权持有人均不对因本软件或本软件的使用或其他交易而产生、引起或与之相关的任何索赔、损害或其他责任承担责任。