# Labby

Labby routes HTTP and stdio MCP servers through one gateway. Use it to filter exposed tools, protect routes, and run Code Mode actions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: dinglebear-ai
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dinglebear-ai/labby
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/labby

## What it does

Labby is a Rust gateway for upstream MCP servers. It accepts HTTP and stdio connections, inspects available tools, resources, and prompts, applies exposure filters, and publishes protected MCP routes. The upstream catalog can also be reduced to Code Mode operations built around `search` and `execute`.

The package includes bearer and OAuth authentication, host setup, health checks, a CLI, an HTTP API, an operator web UI, and logs for `labby serve`. It can launch a single stdio server with `labby proxy`, expose scoped filesystem actions, and keep reusable JavaScript snippets under `$LABBY_HOME`.

Installing the binary does not finish onboarding. You still need to connect an agent provider, choose a discovered model, complete the starter Agent test, and register the client. The installer requires `curl`, `tar`, and `sha256sum` or `shasum`; macOS setup also uses `unzip`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `LABBY_VERSION`, `LABBY_REPO`, `LABBY_LOG` — 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 LABBY_VERSION=<LABBY_VERSION> --env LABBY_REPO=<LABBY_REPO> --env LABBY_LOG=<LABBY_LOG> --transport stdio labby -- npx -y @dinglebear/labby
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add labby --env LABBY_VERSION=<LABBY_VERSION> --env LABBY_REPO=<LABBY_REPO> --env LABBY_LOG=<LABBY_LOG> -- npx -y @dinglebear/labby
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "labby": {
            "command": "npx",
            "args": [
                "-y",
                "@dinglebear/labby"
            ],
            "env": {
                "LABBY_VERSION": "<LABBY_VERSION>",
                "LABBY_REPO": "<LABBY_REPO>",
                "LABBY_LOG": "<LABBY_LOG>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "labby": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@dinglebear/labby"
            ],
            "env": {
                "LABBY_VERSION": "<LABBY_VERSION>",
                "LABBY_REPO": "<LABBY_REPO>",
                "LABBY_LOG": "<LABBY_LOG>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e LABBY_VERSION=<LABBY_VERSION> -e LABBY_REPO=<LABBY_REPO> -e LABBY_LOG=<LABBY_LOG> labby npx -y @dinglebear/labby
```
Replace <…> with your own values

## When to use it
- route HTTP and stdio MCP servers through one gateway
- filter which upstream tools and resources are exposed
- secure MCP routes with bearer or OAuth authentication
- reduce an upstream catalog to Code Mode actions
- search and follow the `labby serve` log stream

## Example prompts
- Connect an upstream MCP server and inspect its tools, resources, and prompts.
- Expose the catalog through Code Mode, then find and run an action with `search` and `execute`.
- Check the gateway health and inspect recent errors from `labby serve`.

## Similar
- [cli-anything-slay-the-spire-ii](https://affpapa.org/en/nevibecode/skills/cli-anything-slay-the-spire-ii.md) — skill · 472 installs
- [gh-cli](https://affpapa.org/en/nevibecode/skills/gh-cli.md) — skill · 6600 installs
- [rivet-sandbox-agent](https://affpapa.org/en/nevibecode/skills/rivet-sandbox-agent.md) — skill · 325 installs
- [Agent Relay](https://affpapa.org/en/nevibecode/mcp/agent-relay.md) — MCP server · ★ 10
- [create-auth](https://affpapa.org/en/nevibecode/skills/create-auth.md) — skill · 13400 installs
- [okx-cex-auth](https://affpapa.org/en/nevibecode/skills/okx-cex-auth.md) — skill · 5900 installs

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