@businessmaps/bifrost

MCP-сервер, который позволяет ИИ-инструментам вызывать функции, выполняемые в вашем браузере.

Демон располагается между любым MCP-клиентом и вкладкой вашего браузера. С одной стороны он использует JSON-RPC через stdio, а с другой — WebSocket. Ваше браузерное приложение подключается, регистрирует инструменты, и ИИ может их вызывать.

Быстрый старт

1. Добавьте в свой ИИ-инструмент

Claude Code:

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

Claude Desktop — добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor — добавьте в .cursor/mcp.json:

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

Установка не требуется. npx автоматически скачивает и запускает пакет.

2. Добавьте клиент в свое браузерное приложение

npm i @businessmaps/bifrost-browser

Или через CDN:

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

TypeScript-типы включены.

3. Зарегистрируйте инструменты

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

Вот и всё. Теперь ИИ может вызывать get_page_title и get_selection во вкладке вашего браузера. Обработчики имеют полный доступ к DOM, Canvas, IndexedDB, буферу обмена, fetch и т. д.

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

Аутентификация

По умолчанию демон генерирует случайный токен при запуске. Есть два способа его получить:

• Терминальный режим — токен выводится на экран при запуске демона

• MCP-режим — ИИ вызывает встроенный инструмент bifrost_connection_info для получения токена, а затем сообщает вам, что нужно вставить в ваше приложение

Передайте токен клиенту:

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

Для локальной разработки можно полностью пропустить аутентификацию с помощью --no-auth.

Несколько вкладок

Каждая вкладка регистрирует свои собственные инструменты. Вызовы направляются тому, кто владеет инструментом. При закрытии вкладки её инструменты удаляются.

Опции

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

Разработка

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

Архитектура · Клиентский API · Участие в разработке

Лицензия

Apache 2.0