fcvm

io.github.carlosbravoa由 GitHub 帳號 carlosbravoa 發布v0.7.0更新於 Oct 24, 2026

Disposable Firecracker microVM sandboxes for agents: run code, snapshot, fork. Needs Linux with KVM.

已驗證STDIO僅桌面雲端與基礎設施開發者工具

概覽

AI 產生的概覽

啟動 fcvm，讓 AI 助理建立一次性 Firecracker microVM 沙箱，用來執行指令、編輯檔案、建置映像與分叉快照。

可以做什麼
在一次性 microVM 沙箱中執行指令並讀寫檔案，每個沙箱約一秒內從 OCI 映像啟動獨立核心。建置映像並提交準備好的沙箱狀態。對執行中的虛擬機建立快照，並在約 150 毫秒內分叉出副本。依沙箱控制網路存取：關閉、完全開放，或由具記錄功能的代理強制執行的主機允許清單。
適用情境
適合助理需要在 Linux 機器上執行不受信任或實驗性程式碼而不影響主機時，也適合希望從已準備好的虛擬機狀態快速分叉、而不必重建環境時使用。
執行需求
需要具備 KVM 的 Linux 主機；fcvm 執行檔須另行安裝並完成初始化，然後位於 PATH、~/.local/bin 或 /usr/local/bin，或以 FCVM_BIN 指定。啟動器透過 uvx 從 fcvm-mcp 的 PyPI 套件執行，因此需要 Python 工具鏈。選用設定皆為環境變數，如 FCVM_MCP_NETWORK、FCVM_MCP_TEMPLATE、FCVM_MCP_TTL、FCVM_MCP_IDLE_STOP、FCVM_MCP_SECRETS、FCVM_MCP_FORWARD、FCVM_MCP_CACHE 與 FCVM_MCP_JAIL。
安裝前請注意
沙箱會執行助理撰寫的程式碼，因此網路策略很重要：建議透過 FCVM_MCP_NETWORK 設為關閉或允許清單。FCVM_MCP_SECRETS 與 FCVM_MCP_FORWARD 會把 ssh-agent、git 或指定權杖等主機憑證傳入每個沙箱，僅在確有需要時啟用。沙箱可寫入檔案並建置映像，未設定 FCVM_MCP_TTL 與 FCVM_MCP_IDLE_STOP 時，被遺忘的沙箱會佔用資源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 fcvm，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

fcvm-mcp

Starts the MCP server of fcvm, which gives an AI agent disposable Firecracker microVMs as sandboxes. Each sandbox boots its own kernel in about a second from any OCI image. The agent gets tools to run commands, read and write files, build images, commit prepared states, and snapshot a VM to fork running copies in about 150 ms. Network access is off, full, or an allowlist of hosts enforced by a logging proxy.

This package is only a launcher: it finds the installed fcvm and runs fcvm mcp. fcvm itself needs a Linux host with KVM:

sh
curl -fsSL https://raw.githubusercontent.com/carlosbravoa/fcvm/main/install.sh | shfcvm setup

Then register the server with your MCP client. With Claude Code:

sh
claude mcp add fcvm -- uvx fcvm-mcpclaude mcp add fcvm -e FCVM_MCP_NETWORK=@pypi,@github -- uvx fcvm-mcp   # agents can only reach PyPI and GitHub

In a client's JSON configuration:

json
{"mcpServers": {"fcvm": {"command": "uvx", "args": ["fcvm-mcp"]}}}

The launcher looks for fcvm on PATH, then in ~/.local/bin and /usr/local/bin. Set FCVM_BIN to use another one. Running fcvm mcp directly works the same way and needs no Python package.

Settings are environment variables: FCVM_MCP_NETWORK pins the network policy, FCVM_MCP_TEMPLATE picks the default template, FCVM_MCP_TTL and FCVM_MCP_IDLE_STOP stop forgotten sandboxes, FCVM_MCP_SECRETS and FCVM_MCP_FORWARD hand credentials to sandboxes without the agent seeing them. The agents guide covers the tools and every setting.

Apache License 2.0.

來源：sdk/mcp/README.md，提交 82d29c2

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.7.0最新Oct 12, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分