fcvm MCP
An MCP server that provides AI agents with tools to manage disposable Firecracker microVM sandboxes. It allows agents to create, snapshot, fork, and execute code within isolated VMs, supporting features like network policy pinning, port publishing, and state management via a stdio interface.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Create and boot isolated VM sandboxes for code execution
- Snapshot and fork running VMs for parallel testing or rollback
- Execute shell commands or background jobs within a sandbox
- Publish TCP ports from a sandbox to the host for access
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
fcvm-mcp 0.7.0
{
"version": "0.7.0",
"transport": "stdio",
"identifier": "fcvm-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "FCVM_MCP_NETWORK",
"description": "Pin the network policy for every sandbox: none, or an allowlist such as @pypi,@github"
},
{
"name": "FCVM_MCP_TEMPLATE",
"description": "Template used when the agent names neither an image nor a template, e.g. python-sandbox"
},
{
"name": "FCVM_MCP_TTL",
"description": "Stop sandboxes this long after boot unless the agent sets a lifetime, e.g. 4h"
},
{
"name": "FCVM_MCP_IDLE_STOP",
"description": "Stop sandboxes that saw no exec or file operation for this long, e.g. 30m"
},
{
"name": "FCVM_MCP_SECRETS",
"description": "Names of environment variables passed into every sandbox as secrets, e.g. GITHUB_TOKEN"
},
{
"name": "FCVM_MCP_FORWARD",
"description": "Host credentials relayed into every sandbox: ssh-agent, git"
},
{
"name": "FCVM_MCP_CACHE",
"description": "1: restricted sandboxes fetch pip and npm packages through the host's mirror"
},
{
"name": "FCVM_MCP_JAIL",
"description": "0: don't run sandboxes under the Firecracker jailer even when it is set up"
},
{
"name": "FCVM_BIN",
"description": "Path of the fcvm command, when it isn't on PATH, in ~/.local/bin or in /usr/local/bin"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"fcvm-mcp": {
"command": "uvx",
"args": [
"fcvm-mcp==0.7.0"
],
"env": {
"FCVM_MCP_NETWORK": "<YOUR_FCVM_MCP_NETWORK>",
"FCVM_MCP_TEMPLATE": "<YOUR_FCVM_MCP_TEMPLATE>",
"FCVM_MCP_TTL": "<YOUR_FCVM_MCP_TTL>",
"FCVM_MCP_IDLE_STOP": "<YOUR_FCVM_MCP_IDLE_STOP>",
"FCVM_MCP_SECRETS": "<YOUR_FCVM_MCP_SECRETS>",
"FCVM_MCP_FORWARD": "<YOUR_FCVM_MCP_FORWARD>",
"FCVM_MCP_CACHE": "<YOUR_FCVM_MCP_CACHE>",
"FCVM_MCP_JAIL": "<YOUR_FCVM_MCP_JAIL>",
"FCVM_BIN": "<YOUR_FCVM_BIN>"
}
}
}
}Cline
{
"mcpServers": {
"fcvm-mcp": {
"command": "uvx",
"args": [
"fcvm-mcp==0.7.0"
],
"env": {
"FCVM_MCP_NETWORK": "<YOUR_FCVM_MCP_NETWORK>",
"FCVM_MCP_TEMPLATE": "<YOUR_FCVM_MCP_TEMPLATE>",
"FCVM_MCP_TTL": "<YOUR_FCVM_MCP_TTL>",
"FCVM_MCP_IDLE_STOP": "<YOUR_FCVM_MCP_IDLE_STOP>",
"FCVM_MCP_SECRETS": "<YOUR_FCVM_MCP_SECRETS>",
"FCVM_MCP_FORWARD": "<YOUR_FCVM_MCP_FORWARD>",
"FCVM_MCP_CACHE": "<YOUR_FCVM_MCP_CACHE>",
"FCVM_MCP_JAIL": "<YOUR_FCVM_MCP_JAIL>",
"FCVM_BIN": "<YOUR_FCVM_BIN>"
}
}
}
}VS Code
{
"servers": {
"fcvm-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"fcvm-mcp==0.7.0"
],
"env": {
"FCVM_MCP_NETWORK": "<YOUR_FCVM_MCP_NETWORK>",
"FCVM_MCP_TEMPLATE": "<YOUR_FCVM_MCP_TEMPLATE>",
"FCVM_MCP_TTL": "<YOUR_FCVM_MCP_TTL>",
"FCVM_MCP_IDLE_STOP": "<YOUR_FCVM_MCP_IDLE_STOP>",
"FCVM_MCP_SECRETS": "<YOUR_FCVM_MCP_SECRETS>",
"FCVM_MCP_FORWARD": "<YOUR_FCVM_MCP_FORWARD>",
"FCVM_MCP_CACHE": "<YOUR_FCVM_MCP_CACHE>",
"FCVM_MCP_JAIL": "<YOUR_FCVM_MCP_JAIL>",
"FCVM_BIN": "<YOUR_FCVM_BIN>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"fcvm-mcp": {
"command": "uvx",
"args": [
"fcvm-mcp==0.7.0"
],
"env": {
"FCVM_MCP_NETWORK": "<YOUR_FCVM_MCP_NETWORK>",
"FCVM_MCP_TEMPLATE": "<YOUR_FCVM_MCP_TEMPLATE>",
"FCVM_MCP_TTL": "<YOUR_FCVM_MCP_TTL>",
"FCVM_MCP_IDLE_STOP": "<YOUR_FCVM_MCP_IDLE_STOP>",
"FCVM_MCP_SECRETS": "<YOUR_FCVM_MCP_SECRETS>",
"FCVM_MCP_FORWARD": "<YOUR_FCVM_MCP_FORWARD>",
"FCVM_MCP_CACHE": "<YOUR_FCVM_MCP_CACHE>",
"FCVM_MCP_JAIL": "<YOUR_FCVM_MCP_JAIL>",
"FCVM_BIN": "<YOUR_FCVM_BIN>"
}
}
}
}Let your agent find its tools
Find servers like fcvm MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.