# NV oOS MCP Bridge

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: nvdigitalsolutions
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nvdigitalsolutions/mcp-ai-wpoos/tree/HEAD/packages/nvoos-mcp-bridge
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/nv-oos-mcp-bridge

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MCP_AI_BASE_URL`, `MCP_AI_TOKEN`, `MCP_AI_HTTP_TIMEOUT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-bridge
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-bridge
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-bridge
```
Replace <…> with your own values

## When to use it
- 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
- Inspect recent system logs on the WordPress site via the NV oOS bridge.
- Trigger a maintenance routine on the connected WordPress instance.

## Similar
- [openclaw-relay](https://affpapa.org/en/nevibecode/skills/openclaw-relay.md) — skill · 120 installs
- [wordpress-setup](https://affpapa.org/en/nevibecode/skills/wordpress-setup.md) — skill · 1600 installs
- [remote-bridge](https://affpapa.org/en/nevibecode/mcp/remote-bridge.md) — MCP server · ★ 5 repo stars
- [public-graphql-api-design](https://affpapa.org/en/nevibecode/skills/public-graphql-api-design.md) — skill · 10100 installs
- [mcp-developer](https://affpapa.org/en/nevibecode/skills/mcp-developer.md) — skill · 4600 installs
- [cli-a2a](https://affpapa.org/en/nevibecode/skills/cli-a2a.md) — skill · 1300 installs

From the same set: [nvdigitalsolutions/mcp-ai-wpoos](https://affpapa.org/en/nevibecode/by/nvdigitalsolutions/mcp-ai-wpoos.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
