analog-circuit-simulate-mcp-server
@abelzhao
the mcp server to run circuit simulation with ngspice
Overview
What is analog-circuit-simulate-mcp-server?
This MCP server provides tools for running analog circuit simulations using ngspice as the simulation backend. It exposes a REST API interface, supports parameterized circuit simulations, and returns results in JSON format. It is intended for users who need to simulate analog circuits within an MCP-enabled environment.
How to use analog-circuit-simulate-mcp-server?
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.
Key features of analog-circuit-simulate-mcp-server
- 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
Use cases of analog-circuit-simulate-mcp-server
- Running analog circuit simulations from MCP clients
- Automating parameterized circuit analysis
- Integrating ngspice simulation into development workflows
FAQ from analog-circuit-simulate-mcp-server
What are the runtime dependencies?
Python 3.8+, the uv package manager, and ngspice installed on the system.
How is the server configured?
Server configuration is set via environment variables: FASTMCP_PORT (default 4044) and FASTMCP_JSON_RESPONSE (set to True for JSON output).
Where can I find an example circuit file?
The repository includes high_pass_filter.cir as an example circuit file for simulation demos.
How do I start the server?
Run uv run analog-circuit-simulate-mcp-server from the project root, or use uvx with the Git repository URL.
What transport method is used?
The server provides a REST API on port 4044 at the /mcp/ endpoint. No authentication mechanisms are mentioned.
