# Ikenga iyke (control bridge)

Control a running Ikenga desktop application via MCP with DOM inspection, clicks, text typing, navigation, and screenshots.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: ikenga-hq
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ikenga-hq/ikenga-pkgs
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/ikenga-iyke-control-bridge

## What it does

This bridge connects AI coding agents to an active Ikenga desktop shell. Through the MCP protocol, an assistant inspects DOM nodes, navigates between internal views, clicks UI elements, and types into fields. It also captures window screenshots to let models verify the interface layout.

The server is maintained inside the official `ikenga-pkgs` Apache-2.0 monorepo and distributed via npm as `@ikenga/mcp-iyke`. The tool relies on a running instance of the `ikenga` desktop program; attempting to execute actions without the shell active fails.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-iyke -- npx -y @ikenga/mcp-iyke
```

### Codex

**Platform CLI**
```bash
codex mcp add ikenga-iyke-control-bridge -- npx -y @ikenga/mcp-iyke
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ikenga-iyke-control-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "@ikenga/mcp-iyke"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ikenga-iyke-control-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@ikenga/mcp-iyke"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ikenga-iyke-control-bridge npx -y @ikenga/mcp-iyke
```

## When to use it
- click buttons and interactive controls inside the running Ikenga app
- type text input directly into open desktop views
- capture screenshots of the active workspace window
- read and traverse DOM elements within the desktop client

## Example prompts
- Take a screenshot of the active Ikenga window and describe the layout
- Inspect the DOM in Ikenga and click the primary submit button
- Navigate to the settings panel in the running desktop app and fill in the field

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826

---
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