MCP Sandpipersaas

🚀 mcp-sandpiperaas

mcp-sandpiperaas 是一個 MCP 服務器，它封裝了 Redwood EDA 的 SandPiper-SaaS 編譯功能，可將 TL‑Verilog（TLV）文件轉換為 SystemVerilog/Verilog。該服務器將 SandPiper 的每個標誌都作為獨立的 MCP 工具參數暴露出來，方便進行內省和自動化操作。簡單來說，用戶可以用自然語言（英語）告知編譯器要執行的操作。若想了解提示示例，可參考 prompt。

該項目使用 UV 來管理虛擬環境和依賴項。

🚀 快速開始

✨ 主要特性

• 封裝 Redwood EDA 的 SandPiper-SaaS 編譯功能，實現 TLV 文件到 SystemVerilog/Verilog 的轉換。
• 將 SandPiper 標誌作為獨立 MCP 工具參數，便於內省和自動化操作。
• 支持使用自然語言（英語）與編譯器交互。

📦 安裝指南

安裝 UV

若尚未安裝 UV CLI，可通過以下方式進行安裝：

• 使用 pip 安裝（無需 pipx）：

pip install --user uv

• 若傾向於通過 pipx 進行隔離安裝：

pipx install uv

安裝完成後，驗證是否已添加到 PATH：

uv --version

初始化 & 安裝依賴項

克隆此倉庫：

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

從項目根目錄運行以下命令：

uv install

此命令將創建（或重用）一個 .venv/ 目錄，並安裝所有必需的軟件包。

💻 使用示例

運行服務器

使用 uv

使用 uv 命令（UV 工具套件的一部分）啟動 MCP 服務器是最簡單的方式：

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

這將通過 stdio 啟動 MCP 服務器，使其準備好接受 tools/list 和 tools/invoke 請求。

使用 uvx

若更喜歡輕量級的 uvx 捆綁：

uvx run mcp-sandpiperasaas.py

它會檢測並運行當前目錄中的 MCP 服務器。

配置 Claude Desktop/Cline

可使用以下 JSON 配置 MCP 服務器（適用於 Cline 或 Claude Desktop，或任何支持 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”）。