🚀 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”）。