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 分