Skip to main content
Glama

tabby-mcp

A lightweight MCP (Model Context Protocol) server that enables control of the Tabby terminal via Chrome DevTools Protocol (CDP).

Features

  • list_targets - List CDP targets (tabs) with index, title, url, ws_url

  • execute_js - Execute JavaScript code in Tabby's Electron context

  • query - Query DOM elements by CSS selector (auto-waits for Angular)

  • screenshot - Capture Tabby window screenshot

Related MCP server: MCP Browser Logger

About this project

This MCP server was built to automate development and testing of TabbySpaces.

TabbySpaces was written 100% by Claude Code - Igor didn't look at the Angular code once. But for this Python project, he has MCP experience and actually reviewed the code.

Here's the fun part: Claude Code (running inside TabbySpaces) served as the tester for this project. The AI that built the plugin now uses this MCP server to test it. Full circle.

Requirements

  • Python 3.10+

  • uv package manager

  • Tabby terminal with CDP debugging enabled

Installation

pip install tabby-mcp

Or with uv:

uv pip install tabby-mcp

From source

git clone https://github.com/halilc4/tabby-mcp.git
cd tabby-mcp
uv sync

Setup

1. Launch Tabby with CDP debugging

tabby.exe --remote-debugging-port=9222

2. Configure Claude Code

Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tabby": {
      "command": "uv",
      "args": ["--directory", "/path/to/tabby-mcp", "run", "tabby-mcp"]
    }
  }
}

Usage

Once configured, Claude Code can interact with Tabby through MCP tools:

# Execute JavaScript
execute_js({ "code": "document.title" })

# Query DOM elements
query({ "selector": ".tab-bar button" })

Architecture

server.py  ->  tools.py  ->  cdp.py  ->  Tabby (CDP port 9222)

Module

Purpose

server.py

MCP server entry point with stdio transport

tools.py

MCP tool definitions and handlers

cdp.py

CDP connection management via pychrome

License

MIT

Available Tools

4 tools
execute_jsA

Execute JavaScript code in Tabby terminal context and return the result. Code is wrapped in async IIFE by default for fresh scope and await support.

Inputs: target (required), code (required), wrap.

list_targetsA

List available CDP targets (tabs) with their index, URL, and WebSocket URL

Inputs: no named parameters.

queryA

Query DOM elements by CSS selector. Automatically waits for Angular and element to exist.

Inputs: target (required), selector (required), include_children, include_text, +1 more.

screenshotB

Capture screenshot of Tabby terminal window or specific element

Inputs: target (required), selector, format, quality, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: execute_js runs code, list_targets lists tabs, query finds DOM elements, screenshot captures images. There is no overlap.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (execute_js, list_targets), but 'query' and 'screenshot' are less consistent. Still, the pattern is understandable.

    Tool Count5/5

    Four tools is appropriate for a focused automation toolkit. Each tool serves a clear function without being excessive or insufficient.

    Completeness3/5

    The set covers basic inspection and execution but lacks common browser actions like navigation, clicking, or typing, which limits its completeness for typical automation tasks.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides tools for interacting with Chrome through its DevTools Protocol, enabling remote control of Chrome tabs to execute JavaScript, capture screenshots, monitor network traffic, and more.
      69 npm
      52
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that captures browser console logs and network requests via the Chrome DevTools Protocol. It allows users to monitor real-time logs, inspect network traffic, and execute JavaScript code directly in the browser context.
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that connects to your browser to capture screenshots, inspect console logs, network requests, and more via Chrome DevTools Protocol.
      2
      -