📦

web-server

A Simple Web Search & Scrape Server, which uses selenium and playwright, and hash router to handle concurrent request.

0 installs

Trust: 39 — Low

Devtools

Installation

npx @ripulio/web-mcp-server

Ask AI about web-server

I know everything about web-server. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

Web MCP

A monorepo implementing the Web Model Context Protocol for browser integration.

The Web MCP specification defines a navigator.modelContext API that allows web pages to register tools for AI assistants to discover and invoke. This repo provides:

An MCP server that connects AI assistants to browser tabs
A Chrome extension that exposes page tools to the MCP server
A polyfill for the navigator.modelContext API
A registry of pre-built tools that can be injected into pages (optional)

How It Works

┌─────────────────────────────────┐
│  AI Assistant (Claude, etc.)   │
└───────────────┬─────────────────┘
                │ stdio
                ▼
┌─────────────────────────────────┐
│     web-mcp-server (CLI)        │
│  MCP server for browser control │
└───────────────┬─────────────────┘
                │ WebSocket
                ▼
┌─────────────────────────────────┐
│   Chrome Extension              │
│  Exposes page tools via MCP     │
└───────────────┬─────────────────┘
                │
                ▼
┌─────────────────────────────────┐
│   Web Pages                     │
│  navigator.modelContext API     │
└─────────────────────────────────┘

Packages

Package	Description
web-mcp-server	MCP server CLI that enables AI assistants to control browser tabs and invoke page tools
web-mcp-extension	Chrome extension for browsing/installing tools and connecting to MCP servers
web-mcp-devtools	Chrome DevTools panel for inspecting and testing tools on pages
webmcp-polyfill	Browser polyfill implementing the `navigator.modelContext` API

Quick Start

1. Install the Chrome Extension

See web-mcp-extension for installation instructions.

2. Configure Your AI Assistant

Add the MCP server to your AI assistant's configuration:

{
  "mcpServers": {
    "web-mcp": {
      "command": "npx",
      "args": ["@ripulio/web-mcp-server"]
    }
  }
}

3. Enable Browser Control

In the extension settings, enable browser control to allow the MCP server to interact with your browser.

Development

# Install dependencies
npm install

# Build all packages
npm run build

# Run tests
npm test

# Lint and format
npm run lint
npm run format

License

MIT