@businessmaps/bifrost

Servidor MCP que permite a las herramientas de IA llamar a funciones que se ejecutan en su navegador.

El demonio se sitúa entre cualquier cliente MCP y la pestaña de su navegador. Habla JSON-RPC a través de stdio por un lado y WebSocket por el otro. Su aplicación de navegador se conecta, registra herramientas y la IA puede llamarlas.

Inicio rápido

1. Añadir a su herramienta de IA

Claude Code:

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

Claude Desktop - añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor - añadir a .cursor/mcp.json:

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

No se requiere instalación. npx descarga y ejecuta el paquete automáticamente.

2. Añadir el cliente a su aplicación de navegador

npm i @businessmaps/bifrost-browser

O mediante CDN:

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

Se incluyen tipos de TypeScript.

3. Registrar herramientas

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();

Eso es todo. La IA ahora puede llamar a get_page_title y get_selection en la pestaña de su navegador. Los controladores tienen acceso completo a DOM, Canvas, IndexedDB, Portapapeles, fetch, etc.

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

Autenticación

Por defecto, el demonio genera un token aleatorio al iniciarse. Hay dos formas de obtenerlo:

• Modo terminal - el token se imprime en pantalla cuando se inicia el demonio

• Modo MCP - la IA llama a la herramienta integrada bifrost_connection_info para obtener el token, y luego le indica qué pegar en su aplicación

Pase el token al cliente:

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

Omita la autenticación por completo con --no-auth durante el desarrollo local.

Pestañas múltiples

Cada pestaña registra sus propias herramientas. Las llamadas se dirigen a quien sea propietario de la herramienta. Desconectar una pestaña elimina sus herramientas.

Opciones

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

Desarrollo

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

Arquitectura · API del cliente · Contribución

Licencia

Apache 2.0