Lets AI assistants interact with the VergeOS virtualization platform, locally over stdio or remotely over HTTP.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add vergeos --env VERGEOS_HOST='<VERGEOS_HOST>' --env VERGEOS_MCP_URL='<VERGEOS_MCP_URL>' --env VERGEOS_PASS='<VERGEOS_PASS>' --env VERGEOS_USER='<VERGEOS_USER>' -- node /path/to/vergeos-mcp-server/src/index.js~/.codex/config.toml
[mcp_servers.vergeos]
command = "node"
args = ["/path/to/vergeos-mcp-server/src/index.js"]
env = { VERGEOS_HOST = "<VERGEOS_HOST>", VERGEOS_MCP_URL = "<VERGEOS_MCP_URL>", VERGEOS_PASS = "<VERGEOS_PASS>", VERGEOS_USER = "<VERGEOS_USER>" }
# codex mcp add vergeos --env VERGEOS_HOST='<VERGEOS_HOST>' --env VERGEOS_MCP_URL='<VERGEOS_MCP_URL>' --env VERGEOS_PASS='<VERGEOS_PASS>' --env VERGEOS_USER='<VERGEOS_USER>' -- node /path/to/vergeos-mcp-server/src/index.js~/.cursor/mcp.json
{
"mcpServers": {
"vergeos": {
"command": "node",
"args": [
"/path/to/vergeos-mcp-server/src/index.js"
],
"env": {
"VERGEOS_HOST": "<VERGEOS_HOST>",
"VERGEOS_MCP_URL": "<VERGEOS_MCP_URL>",
"VERGEOS_PASS": "<VERGEOS_PASS>",
"VERGEOS_USER": "<VERGEOS_USER>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"vergeos": {
"type": "stdio",
"command": "node",
"args": [
"/path/to/vergeos-mcp-server/src/index.js"
],
"env": {
"VERGEOS_HOST": "<VERGEOS_HOST>",
"VERGEOS_MCP_URL": "<VERGEOS_MCP_URL>",
"VERGEOS_PASS": "<VERGEOS_PASS>",
"VERGEOS_USER": "<VERGEOS_USER>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"vergeos": {
"command": "node",
"args": [
"/path/to/vergeos-mcp-server/src/index.js"
],
"env": {
"VERGEOS_HOST": "<VERGEOS_HOST>",
"VERGEOS_MCP_URL": "<VERGEOS_MCP_URL>",
"VERGEOS_PASS": "<VERGEOS_PASS>",
"VERGEOS_USER": "<VERGEOS_USER>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"vergeos": {
"command": "node",
"args": [
"/path/to/vergeos-mcp-server/src/index.js"
],
"env": {
"VERGEOS_HOST": "<VERGEOS_HOST>",
"VERGEOS_MCP_URL": "<VERGEOS_MCP_URL>",
"VERGEOS_PASS": "<VERGEOS_PASS>",
"VERGEOS_USER": "<VERGEOS_USER>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"vergeos": {
"command": "node",
"args": [
"/path/to/vergeos-mcp-server/src/index.js"
],
"env": {
"VERGEOS_HOST": "<VERGEOS_HOST>",
"VERGEOS_MCP_URL": "<VERGEOS_MCP_URL>",
"VERGEOS_PASS": "<VERGEOS_PASS>",
"VERGEOS_USER": "<VERGEOS_USER>"
}
}
}
}Environment variables
VERGEOS_HOSTVERGEOS_MCP_URLVERGEOS_PASSVERGEOS_USER
Replace the placeholders with your own credentials and keep them out of version control.