NV oOS MCP Bridge — Claude Code MCP server: features and install
NV oOS MCP Bridge relays JSON-RPC 2.0 messages between editor stdio streams and NV oOS WordPress HTTP endpoints. Useful for running WordPress operations directly from coding agents.
no license ★ 7 updated 2026-10-24
claude mcp add --env MCP_AI_BASE_URL=<MCP_AI_BASE_URL> --env MCP_AI_TOKEN=<MCP_AI_TOKEN> --env MCP_AI_HTTP_TIMEOUT=<MCP_AI_HTTP_TIMEOUT> --transport stdio nvoos-mcp-bridge -- npx -y @nvdigitalsolutions/nvoos-mcp-bridgeWhat NV oOS MCP Bridge does
Coding assistants communicate with local tools using stdio streams. Meanwhile, NV oOS endpoints on WordPress run over HTTP. This bridge reads JSON-RPC 2.0 requests from standard input and forwards them as POST requests to /wp-json/mcp-ai/v1/mcp. Responses go straight to standard output, while diagnostics stay on stderr.
Two binaries are available. The default command handles direct HTTPS web traffic. A secondary executable runs an SSH tunnel on port 22, targeting droplets without public HTTP access.
The SSH bridge requires passwordless key authentication. Without it, the process hangs. Store sensitive tokens in ~/.nvoos-bridge.env to keep credentials hidden from system process tables.
What it helps with
- link coding agents to WordPress NV oOS endpoints via stdio
- tunnel MCP traffic to private droplets using automated SSH port forwarding
- keep bearer tokens out of process listings using an environment file
Example prompts for the agent
- Inspect recent system logs on the WordPress site via the NV oOS bridge.
- Trigger a maintenance routine on the connected WordPress instance.
How to install NV oOS MCP Bridge
Platform CLI
claude mcp add --env MCP_AI_BASE_URL=<MCP_AI_BASE_URL> --env MCP_AI_TOKEN=<MCP_AI_TOKEN> --env MCP_AI_HTTP_TIMEOUT=<MCP_AI_HTTP_TIMEOUT> --transport stdio nvoos-mcp-bridge -- npx -y @nvdigitalsolutions/nvoos-mcp-bridgeReplace <…> with your own values
Platform CLI
codex mcp add nvoos-mcp-bridge --env MCP_AI_BASE_URL=<MCP_AI_BASE_URL> --env MCP_AI_TOKEN=<MCP_AI_TOKEN> --env MCP_AI_HTTP_TIMEOUT=<MCP_AI_HTTP_TIMEOUT> -- npx -y @nvdigitalsolutions/nvoos-mcp-bridgeReplace <…> with your own values
Config file
{
"mcpServers": {
"nvoos-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"@nvdigitalsolutions/nvoos-mcp-bridge"
],
"env": {
"MCP_AI_BASE_URL": "<MCP_AI_BASE_URL>",
"MCP_AI_TOKEN": "<MCP_AI_TOKEN>",
"MCP_AI_HTTP_TIMEOUT": "<MCP_AI_HTTP_TIMEOUT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"nvoos-mcp-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nvdigitalsolutions/nvoos-mcp-bridge"
],
"env": {
"MCP_AI_BASE_URL": "<MCP_AI_BASE_URL>",
"MCP_AI_TOKEN": "<MCP_AI_TOKEN>",
"MCP_AI_HTTP_TIMEOUT": "<MCP_AI_HTTP_TIMEOUT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MCP_AI_BASE_URL=<MCP_AI_BASE_URL> -e MCP_AI_TOKEN=<MCP_AI_TOKEN> -e MCP_AI_HTTP_TIMEOUT=<MCP_AI_HTTP_TIMEOUT> nvoos-mcp-bridge npx -y @nvdigitalsolutions/nvoos-mcp-bridgeReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about NV oOS MCP Bridge
How to install NV oOS MCP Bridge in Claude Code?
Run claude mcp add nvoos-mcp-bridge -e MCP_AI_BASE_URL=<MCP_AI_BASE_URL> -e MCP_AI_TOKEN=<MCP_AI_TOKEN> -- npx -y @nvdigitalsolutions/nvoos-mcp-bridge.
What does NV oOS MCP Bridge do?
It relays JSON-RPC 2.0 calls from an editor stdio channel to a WordPress site running the NV oOS endpoint.
How do you connect to a firewalled host?
Pass the ssh parameter to npx and supply MCP_AI_SSH_USER alongside MCP_AI_SSH_HOST. Working non-interactive SSH key access is mandatory.