fsb-mcp-server

library0.7.3jsnpmunverified

FSB MCP Server (v0.7.3) is a Node.js server that bridges the Model Context Protocol (MCP) to the FSB Chrome Extension, enabling AI agents (Claude, Cursor, Windsurf, etc.) to control a browser across four modes: manual, visual session, autopilot, and agent. Released under MIT license with active development (multiple releases per month), it offers 62+ tools for fine-grained browser automation, self-documenting tool descriptions, cookie consent auto-dismiss, site-aware search, and vault tools for secure credential access. Unlike Puppeteer-based solutions, it uses a Chrome extension for direct interaction with the user's existing browser session, preserving login state and avoiding remote debugging protocol complexities.

llm-agents testing devops

github ↗package ↗homepage ↗

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Package is ESM-only since v0.3.0. CommonJS require() will fail with ERR_REQUIRE_ESM.

import { FSBServer } from 'fsb-mcp-server'

createServer is a named export, not default. Default export is undefined.

import { createServer } from 'fsb-mcp-server'

FSBConfig is a TypeScript type-only export. Use import type to avoid runtime errors.

import type { FSBConfig } from 'fsb-mcp-server'

Creates and starts an MCP server connected to the FSB Chrome Extension via stdio or HTTP transport.

import { createServer } from 'fsb-mcp-server'; const server = createServer({ transport: 'stdio', port: 7225, httpPort: 7226, extensionUrl: 'ws://localhost:7225', }); await server.start(); console.log('FSB MCP Server running on stdio'); // Or with Streamable HTTP: // const httpServer = createServer({ transport: 'http', httpPort: 7226 }); // await httpServer.start(); // console.log('HTTP MCP endpoint at http://127.0.0.1:7226/mcp');

Debug

Known footguns

breakingBreaking change: v0.3.0 switched from CommonJS to ESM-only exports. Requires Node >= 18 and "type": "module" in package.json, or use dynamic import().

breakingBreaking change: v0.3.0 renamed the main export from McpServer to FSBServer; createServer() was introduced in v0.4.0 as the recommended way to instantiate.

deprecatedFSBServer constructor is deprecated since v0.4.0. Use createServer() factory function instead.

gotchaThe default transport is stdio; to use HTTP/Streamable HTTP, you must explicitly set transport to 'http'. The httpPort option is ignored in stdio mode.

gotchaIf the FSB Chrome Extension is not installed or not connected, the server will start but all browser automation tools will fail with errors like 'Extension not connected'. The server does not auto-launch Chrome.

Upgrade

Version history

Breaking-change detection hasn't run for this library yet.

Audit

Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity

14 hits · last 30 days

gptbot

ahrefsbot

dotbot

script

bingbot

Resources

githubhttps://github.com/lakshmanturlapati/FSB ↗

packagehttps://www.npmjs.com/package/fsb-mcp-server ↗

homepagehttps://fsb.space ↗