mcp-sandpiperaas

mcp-sandpiperaas

Redwood EDA の SandPiper-SaaS コンパイル関数をラップし、TL-Verilog（TLV）ファイルを SystemVerilog／Verilog に変換する MCP サーバーです。 すべての SandPiper フラグを個別の MCP ツールパラメーターとして公開するため、内容を確認しやすく、自動化も簡単です。つまり、コンパイラーに何をさせたいかを自然言語（英語）で伝えます。 プロンプトの例については、prompt を参照してください。

このプロジェクトでは、仮想環境と依存関係の管理に UV を使用しています。

UV のインストール

UV CLI がまだインストールされていない場合は、pip だけでインストールできます（pipx は不要です）。

pip install --user uv

または、pipx を使って分離された環境にインストールすることもできます。

pipx install uv

PATH に追加されていることを確認します。

uv --version

初期化、依存関係のインストール、依存関係のインストール

このリポジトリをクローンします

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

プロジェクトのルートディレクトリから、次を実行します。

uv install

これにより、.venv/ ディレクトリが作成（または再利用）され、必要なすべてのパッケージがインストールされます。

サーバーの実行

uv を使用する場合

MCP サーバーを起動する最も簡単な方法は、uv コマンド（UV ツールキットの一部）を使用することです。

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

これにより、MCP サーバーが stdio 経由で起動し、tools/list および tools/invoke リクエストを受け付けられる状態になります。

uvx を使用する場合

軽量な uvx バンドルを使う場合は、次のようにします。

uvx run mcp-sandpiperasaas.py

現在のディレクトリにある MCP サーバーを検出して実行します。

Claude Desktop／Cline の設定

Cline、Claude Desktop、または少なくとも MCP ツール呼び出しに対応する任意の MCP クライアントでは、次の JSON を使って MCP サーバーを設定できます。（Windows では、パスの / を \\ に置き換えてください）

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

• command：使用する CLI（uv または uvx）
• args：プロジェクトフォルダーと MCP スクリプトを指定する引数
• autoApprove：追加の確認なしで実行できるツール名の一覧（“sandpiper_compile”）