Agent Bridge
An MCP-only server that launches AI CLI tasks (Claude, Codex, Gemini, Forge, OpenCode) as background subprocesses and manages them via PID for status, output, and lifecycle control.
What is Agent Bridge?
Agent Bridge is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp-only server that launches ai cli tasks (claude, codex, gemini, forge, opencode) as background subprocesses and manages them via pid for status, output, and lifecycle control.
An MCP-only server that launches AI CLI tasks (Claude, Codex, Gemini, Forge, OpenCode) as background subprocesses and manages them via PID for status, output, and lifecycle control.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP-only server that launches AI CLI tasks (Claude, Codex
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx agent-bridgeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Agent Bridge
agent-bridge-mcp is a Node.js stdio MCP server that enables an MCP client to launch Claude CLI, Codex CLI, Forge CLI, OpenCode CLI, or Antigravity CLI as background child processes, returning a PID immediately rather than blocking until completion. It exposes tools to inspect process status, retrieve output, peek at live stdout, wait for completion, terminate processes, and clean up—all without the MCP client needing to manage subprocesses directly. It is designed for developers who want to delegate long-running coding tasks to local AI CLIs while keeping their MCP client responsive.
Prerequisites
- Node.js 20.19.0 or later (or Node.js 22.12.0+)
- npm installed
- At least one supported AI CLI installed locally (Claude CLI, Codex CLI, Forge CLI, OpenCode CLI, or Antigravity CLI) and authenticated
- An MCP-compatible client that supports stdio servers
Install the npm package globally
Install agent-bridge-mcp-server from npm to get the agent-bridge-mcp executable on your PATH.
npm install -g agent-bridge-mcp-serverAlternatively, build from source
Clone the repository and build locally if you prefer to run from source or contribute to development.
git clone https://github.com/lailai258/agent-bridge-mcp.git
cd agent-bridge-mcp
npm install
npm run buildEnsure your AI CLIs are installed and authenticated
agent-bridge-mcp launches local CLIs — it does not call model APIs directly. Run doctor from your MCP client to check which CLIs are available and executable. Log in to each CLI you plan to use beforehand.
Add to your MCP client configuration
Configure the server in your MCP client. Process metadata and logs are persisted under ~/.agent-bridge-mcp by default; override with AGENT_BRIDGE_PROCESS_REGISTRY_DIR.
{
"mcpServers": {
"agent-bridge-mcp": {
"command": "agent-bridge-mcp",
"args": [],
"env": {
"AGENT_BRIDGE_PROCESS_REGISTRY_DIR": "/home/user/.agent-bridge-mcp"
}
}
}
}Restart your MCP client and verify
Restart the client to load the server. Use the doctor tool to confirm which agent CLIs are detected. Then use the run tool to launch your first background agent task.
Agent Bridge Examples
Client configuration
Stdio server configuration pointing at the globally installed agent-bridge-mcp binary.
{
"mcpServers": {
"agent-bridge-mcp": {
"command": "agent-bridge-mcp",
"args": []
}
}
}Prompts to try
Example prompts that launch, monitor, and retrieve results from background AI CLI agents.
- "Use agent-bridge to start a Codex agent in /home/user/myproject that reviews the codebase and identifies the most critical test failures"
- "Check the status of the background agent with PID 12345"
- "Peek at the latest output from the running Claude agent and show me what it's currently doing"
- "Wait for all running agent processes and report their exit codes when complete"
- "List all tracked agent processes and show their current status"Troubleshooting Agent Bridge
run tool returns 'CLI not found' or 'binary not executable'
The doctor tool only checks whether the CLI binary is resolvable—it does not validate login state. Ensure the target CLI (e.g., claude, codex, forge) is installed and on PATH, and that you have completed the CLI's authentication flow (login, terms acceptance).
Process metadata is lost after MCP server restarts
agent-bridge-mcp persists process metadata and log paths under ~/.agent-bridge-mcp. The registry is re-read on startup to recover tracked jobs. If the directory is missing or permissions are wrong, set AGENT_BRIDGE_PROCESS_REGISTRY_DIR to a writable path.
Antigravity or legacy Gemini model names are rejected
Gemini CLI support was removed because that CLI is no longer maintained. Use 'antigravity' as the model value to select the Antigravity CLI. Legacy gemini-* and gemini-ultra model strings are explicitly rejected.
Frequently Asked Questions about Agent Bridge
What is Agent Bridge?
Agent Bridge is a Model Context Protocol (MCP) server that mcp-only server that launches ai cli tasks (claude, codex, gemini, forge, opencode) as background subprocesses and manages them via pid for status, output, and lifecycle control. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Agent Bridge?
Follow the installation instructions on the Agent Bridge GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Agent Bridge?
Agent Bridge works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Agent Bridge free to use?
Yes, Agent Bridge is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Agent Bridge Alternatives — Similar Coding Agents Servers
Looking for alternatives to Agent Bridge? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Agent Bridge in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Agent Bridge?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.