@businessmaps/bifrost

MCP-Server, mit dem KI-Tools Funktionen aufrufen können, die in Ihrem Browser ausgeführt werden.

Der Daemon fungiert als Vermittler zwischen einem beliebigen MCP-Client und Ihrem Browser-Tab. Er kommuniziert auf der einen Seite über JSON-RPC via stdio und auf der anderen Seite über WebSocket. Ihre Browser-App stellt eine Verbindung her, registriert Tools, und die KI kann diese aufrufen.

Schnellstart

1. Zu Ihrem KI-Tool hinzufügen

Claude Code:

claude mcp add --transport stdio bifrost -- npx @businessmaps/bifrost --no-auth

Claude Desktop - hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bifrost": {
      "command": "npx",
      "args": ["@businessmaps/bifrost", "--no-auth"]
    }
  }
}

Cursor - hinzufügen zu .cursor/mcp.json:

{
  "mcpServers": {
    "bifrost": {
      "command": "npx",
      "args": ["@businessmaps/bifrost", "--no-auth"]
    }
  }
}

Keine Installation erforderlich. npx lädt das Paket automatisch herunter und führt es aus.

2. Den Client zu Ihrer Browser-App hinzufügen

npm i @businessmaps/bifrost-browser

Oder via CDN:

<script src="https://unpkg.com/@businessmaps/bifrost-browser"></script>

TypeScript-Typen sind enthalten.

3. Tools registrieren

import { BifrostBrowser } from "@businessmaps/bifrost-browser";

const bridge = new BifrostBrowser({ port: 3099 });

bridge.registerTools([
  {
    name: "get_page_title",
    description: "Returns the page title",
    inputSchema: { type: "object", properties: {} },
    handler: async () => document.title,
  },
  {
    name: "get_selection",
    description: "Returns the user's current text selection",
    inputSchema: { type: "object", properties: {} },
    handler: async () => window.getSelection().toString(),
  },
]);

bridge.connect();

Das war's. Die KI kann nun get_page_title und get_selection in Ihrem Browser-Tab aufrufen. Handler haben vollen Zugriff auf DOM, Canvas, IndexedDB, Zwischenablage, fetch usw.

Related MCP server: @teatak/mcp-server-browser

Authentifizierung

Standardmäßig generiert der Daemon beim Start ein zufälliges Token. Es gibt zwei Möglichkeiten, es zu erhalten:

• Terminal-Modus - das Token wird auf dem Bildschirm ausgegeben, wenn der Daemon startet

• MCP-Modus - die KI ruft das integrierte Tool bifrost_connection_info auf, um das Token zu erhalten, und sagt Ihnen dann, was Sie in Ihre App einfügen müssen

Übergeben Sie das Token an den Client:

const bridge = new BifrostBrowser({ port: 3099, token: "TOKEN" });

Überspringen Sie die Authentifizierung vollständig mit --no-auth während der lokalen Entwicklung.

Mehrere Tabs

Jeder Tab registriert seine eigenen Tools. Aufrufe werden an denjenigen weitergeleitet, der das Tool besitzt. Das Trennen eines Tabs entfernt dessen Tools.

Optionen

--port <port>     WebSocket port        (default: 3099)
--timeout <secs>  Tool call timeout     (default: 120)
--no-auth         Disable token auth    (dev only)
--help, -h        Show this message
--version, -v     Show version

Entwicklung

git clone https://github.com/Business-Maps/bifrost.git && cd bifrost
npm install
npm test

Architektur · Client-API · Mitwirken

Lizenz

Apache 2.0