# zcode-agent-bridge

**Repository Path**: huige9999/zcode-agent-bridge

## Basic Information

- **Project Name**: zcode-agent-bridge
- **Description**: zcode MCPServer用于桥接claudecode cursor codex等子代理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zcode-agent-bridge

An MCP server that lets ZCode act as the main agent workbench while delegating local tasks to other CLI agents:

- Claude Code CLI (`claude`)
- Codex CLI (`codex`)
- Cursor CLI Agent (`agent`)

## Tools

- `delegate_to_claude_code`
- `delegate_to_codex`
- `delegate_to_cursor`
- `list_agent_jobs`
- `read_agent_job`
- `cancel_agent_job`

## Behavior

On startup, the server checks which supported agent CLIs are installed.

- If none are available, startup fails with a clear error.
- If only some are available, the server still starts.
- Calling an unavailable delegate tool returns structured JSON telling the model which agents are available.

Delegated tasks run as local child processes in the requested `cwd` or the server's current working directory. The delegate tools return immediately with a `jobId`; use `read_agent_job` to fetch stdout/stderr and completion state.

## Development

```bash
npm install
npm run typecheck
npm run build
```

## MCP Config Example

```json
{
  "mcpServers": {
    "zcode-agent-bridge": {
      "command": "node",
      "args": ["D:/workspace-learn/zcode-agent-bridge/dist/index.js"]
    }
  }
}
```

If ZCode starts MCP with a minimal `PATH`, the bridge automatically looks for Cursor Agent at:

- `%LOCALAPPDATA%\cursor-agent\agent.ps1`

You can also pin the executable explicitly:

```json
{
  "mcpServers": {
    "zcode-agent-bridge": {
      "command": "node",
      "args": ["D:/workspace-learn/zcode-agent-bridge/dist/index.js"],
      "env": {
        "ZCODE_CURSOR_AGENT_PATH": "C:/Users/you/AppData/Local/cursor-agent/agent.ps1"
      }
    }
  }
}
```

Build before using the `dist/index.js` entrypoint:

```bash
npm run build
```