Skip to main content
Glama
README.md
# @kernline/mcp

Local MCP server for the [Kernline](https://kernline.dev) browser extension. It lets Cursor, Claude Desktop and other MCP clients read inspection output (CSS, Tailwind, design tokens, Copy for AI bundles) from tabs where the Kernline panel is open.

Public source for this package is the read-only mirror [devson-software/kernline-mcp](https://github.com/devson-software/kernline-mcp). Kernline copies this folder there on push. Do not edit the mirror.

Everything stays on your computer. The server listens on `127.0.0.1` only, accepts connections from the Kernline extension only, and proves itself with a pairing token before any data is shared. Kernline never receives page content on its servers. Your AI app may send what it reads to its own model provider.

## Setup

1. In Kernline, open **Settings**, go to **MCP server**, tick **Enable MCP server**, then click **Copy token**.
2. Add the server to your MCP client with that token.

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "kernline": {
      "command": "npx",
      "args": ["-y", "@kernline/mcp"],
      "env": { "KERNLINE_BRIDGE_TOKEN": "paste-your-token" }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

Use the same `kernline` block under `mcpServers`.

3. Open the Kernline panel on a tab, then ask your AI app to use the Kernline tools.

## Options

- `KERNLINE_BRIDGE_TOKEN` (required) is the pairing token from Kernline settings.
- `KERNLINE_BRIDGE_PORT` (optional, default `47321`) must match the port in Kernline settings.

Requires Node.js 18 or newer. Pro tools (Copy for AI, page tokens) need a Kernline Pro licence in the extension.

## License

MIT, made by [Devson Software](https://www.devson.co.za) in South Africa. The Kernline browser extension itself is not open source.

TDQS

A3.5/5.0

Scored across 10 tools

Disambiguation4/5

Most tools have clearly distinct purposes: tab listing, page summary, asset listing/fetching, screenshot capture, and pinning are well separated. The main ambiguity is among inspect, copy_for_ai, component_capture, and element_image, which all operate on a pinned element or selector, though their output formats are described differently.

Naming Consistency4/5

All tools use a consistent kernline_ prefix and snake_case naming, making the set easy to scan. However, the naming mixes verbs and nouns (e.g., kernline_inspect, kernline_pin vs. kernline_page_summary, kernline_assets) rather than following a strict verb_noun pattern.

Tool Count5/5

Ten tools is well-scoped for a browser/design inspection bridge, falling comfortably within the typical 3-15 range. Each tool appears to cover a distinct inspection or capture capability without excessive surface area.

Completeness4/5

The surface covers the core lifecycle well: listing tabs, inspecting pages/elements, capturing styles/components/tokens, listing and fetching assets, screenshotting, and pinning elements. Minor gaps exist, such as no explicit unpin/clear-selection operation and limited asset fetching for binary files, but these are likely workable.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues