Kira Bridge

Local MCP bridge for Kira AI. Runs stdio-based MCP servers (filesystem, Playwright, etc.) on your machine and exposes them to the cloud-deployed Kira web app via a secure tunnel.

How It Works

Your Machine                          Cloud (Vercel)
┌──────────────────────┐              ┌──────────────────┐
│  Kira Bridge (Electron)            │  Kira Web App    │
│  ┌──────────────────┐│   tunnel    │                  │
│  │ Filesystem MCP   ││◄──────────►│  mcp-client.ts   │
│  │ Playwright MCP   ││  (SSE)     │  connects via    │
│  │ ... other MCPs   ││            │  tunnel URL      │
│  └──────────────────┘│            └──────────────────┘
│  HTTP:4321 → SSE     │
│  localtunnel → public│
└──────────────────────┘

1. Bridge spawns local MCP servers as child processes (stdio transport)
2. Bridge runs an HTTP server that serves MCP protocol over SSE
3. localtunnel creates a public URL pointing to the local HTTP server
4. Bridge registers the tunnel URL with Kira as an SSE MCP connection
5. Kira's mcp-client.ts connects to it like any other SSE MCP server

Setup

cd kira-bridge
npm install

Development

npm run dev    # Build + launch Electron

Build Installers

npm run dist        # Build for current platform
npm run dist:mac    # macOS .dmg + .zip
npm run dist:win    # Windows .exe (NSIS installer)

Installers output to kira-bridge/out/.

Configuration

On first launch, the Bridge opens a config window:

1. Kira URL — Your deployed Kira web app URL (e.g. https://kira.vercel.app)
2. API Key — Your Kira API key (for auto-registration)
3. Bridge Port — Local port for the SSE server (default: 4321)
4. Tunnel Subdomain — Optional stable subdomain for the tunnel

Then add local MCP servers from the catalog (Filesystem, Playwright, etc.) and hit Start.

Available Local MCP Servers

| Server | What it does | Config | |--------|-------------|--------| | Filesystem | Read/write files on your machine | Needs a directory path | | Playwright | Browser automation, screenshots, form filling | None | | Puppeteer | Lightweight browser automation | None | | Memory | Persistent knowledge graph | None | | GitHub | Repo/issue/PR management | Needs GITHUB_TOKEN | | Fetch / HTTP | Make HTTP requests to any API | None |

Kira-Side API

The bridge registers itself via POST /api/bridge/register:

{
  "bridgeUrl": "https://your-tunnel.loca.lt"
}

This creates/updates an MCP connection named "Local Bridge" (SSE transport) in the organization's mcp_connections table. Kira auto-discovers tools on next chat message.