analog-circuit-simulate-mcp-server

by abelzhao

225 downloads
Not rated
GitHub

About

the mcp server to run circuit simulation with ngspice

Details

Author
abelzhao
Downloads
225
Categories
Other

- Provides MCP tools for analog circuit simulation
- REST API interface for simulation control
- Supports parameterized circuit simulations
- Returns simulation results in JSON format
- Backed by the ngspice circuit simulator

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name analog-circuit-simulate-mcp-server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install ngspice (Linux only), Python 3.8+ and the uv tool. Create a virtual environment with uv venv .venv and activate it. Install dependencies via uv pip install -e .. Start the server with uv run analog-circuit-simulate-mcp-server or via uvx. Add an NPX configuration entry pointing to http://${server_ip}:4044/mcp/. Server ports and JSON response can be configured via the environment variables FASTMCP_PORT (default 4044) and FASTMCP_JSON_RESPONSE.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "analog-circuit-simulate-mcp-server": {
            "analog_circuit_simulate_mcp_server": {
                "command": "uv",
                "args": [
                    "venv",
                    ".venv"
                ]
            }
        }
    }
}

McpServers

{
    "analog_circuit_simulate_mcp_server": {
        "command": "uv",
        "args": [
            "venv",
            ".venv"
        ]
    }
}

analog-circuit-simulate-mcp-server

A Model Context Protocol (MCP) server for analog circuit simulation

Features

- Provides MCP tools for running analog circuit simulations
- REST API interface for simulation control
- Supports parameterized circuit simulations
- Returns simulation results in JSON format

Installation Guide (Linux only)

1. Install ngspice (required for simulation backend):

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

2. Ensure Python 3.8+ is installed (see .python-version file) and install uv tool:

   pip install uv

3. Create and activate virtual environment:

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

4. Install dependencies using different methods:
- Direct installation with uv:

     uv pip install -e .

- Build with uv then install:
     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

- Traditional pip installation:
     pip install -e .

Usage

Starting the Server

Different ways to run the server: - Using uv run:
  uv run analog-circuit-simulate-mcp-server
  
- Using uvx (requires uvx installation):
  uvx --from https://github.com/abelzhao/analog_circuit_simulate_mcp_server.git analog-circuit-simulate-mcp-server
  

NPX Configuration

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

Configuration Options

Server configuration can be modified in .venv:
- FASTMCP_PORT=4044
- FASTMCP_JSON_RESPONSE=True

Development Guide

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.