mcp-sandpiperaas

by shariethernet

366 downloads
Not rated
GitHub

About

An MCP server for sandpiper - a TL-Verilog compiler, that outputs SystemVerilog/Verilog

Details

Author
shariethernet
Downloads
366
Categories
Other

- Converts TL‑Verilog (TLV) to SystemVerilog/Verilog via SandPiper-SaaS.
- Each SandPiper compiler flag is a separate MCP tool parameter.
- Accepts natural‑language descriptions of desired compilation.
- Runs as an MCP server over stdio.
- Uses UV for dependency and virtual environment management.

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 mcp-sandpiperaas
    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 UV, clone the repository, and run uv install from the project root. Start the server with uv --directory <path> run mcp-sandpiperaas.py or uvx run mcp-sandpiperaas.py. Configure any MCP client (e.g., Claude Desktop or Cline) using the provided JSON with autoApprove set to "sandpiper_compile".

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "mcp-sandpiperaas": {
            "mcp-sandpipersaas": {
                "command": "uv",
                "args": [
                    "--directory",
                    "<path_to_this_repo>/mcp-sandpiperasaas",
                    "run",
                    "mcp-sandpiperasaas.py"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-sandpipersaas": {
        "command": "uv",
        "args": [
            "--directory",
            "<path_to_this_repo>/mcp-sandpiperasaas",
            "run",
            "mcp-sandpiperasaas.py"
        ]
    }
}

mcp-sandpiperaas

A MCP server that wraps Redwood EDA’s SandPiper-SaaS compile function to convert TL‑Verilog (TLV) files into SystemVerilog/Verilog.
Exposes every SandPiper flag as its own MCP tool parameter for introspection and easy automation. In other words, tell in natural language(English) what you want the compiler to do.
Refer prompt for prompt examples.

This project uses UV to manage its virtual environment and dependencies.

Install UV

If you don’t already have the UV CLI installed, you can install it using just pip (no pipx required):

pip install --user uv

Or, if you prefer an isolated install via pipx:
pipx install uv

Verify that it’s on your PATH:

uv --version

Initialize & install dependencies & install dependencies

Clone this repo
git clone https://github.com/shariethernet/mcp-sandpipersaas.git

From the project root, run:

uv install

This will create (or reuse) a .venv/ directory and install all required packages.

Running the server

With uv

The easiest way to start the MCP server is via the uv command (part of the UV toolkit):

uv --directory <path_to_this_repo>/mcp-sandpiperasaas run mcp-sandpiperasaas.py

This will launch the MCP server over stdio, ready to accept tools/list and tools/invoke requests.

With uvx

If you prefer the lightweight uvx bundle:

uvx run mcp-sandpiperasaas.py

It will detect and run the MCP server in the current directory.

Claude Desktop/Cline configuration

You can configure your MCP-server with the following json for Cline or Claude Desktop or any MCP Client that atleast supports mcp tool calling: (Note for paths in windows use \\ instead of /)

{
  "mcp-sandpiperasaas": {
    "command": "uv",
    "args": [
      "--directory",
      "<path to this repo>/mcp-sandpiperasaas",
      "run",
      "mcp-sandpiperasaas.py"
    ],
    "autoApprove": [
      "sandpiper_compile"
    ]
  }
}

- command: the CLI you use (uv or uvx)
- args: arguments to point at the project folder and mcp script
- autoApprove: list of tool names that can run without extra confirmation (“sandpiper_compile”)

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.