webmcp-bridge

Bridge local MCP clients to browser WebMCP tools through native-first browser runtimes and thin fallback adapters.

Adapters

Adapters are the fallback path for sites that do not expose native browser WebMCP.

They are used only when native WebMCP is unavailable.

Built-In Adapters

Adapter Rules

  • browser-side execution first
  • fail closed on auth or ambiguous state
  • keep tool payloads JSON-serializable
  • keep site-specific behavior out of shared bridge packages
  • use adapters only for research, development, testing, and normal authorized user workflows
  • do not treat repository-provided adapters as a bulk-collection or bypass toolkit

Creating New Adapters

This repo also includes a dedicated authoring workflow:

  • Skills for webmcp-adapter-creator
Adapter: Fixture`@webmcp-bridge/adapter-fixture` is a deterministic fallback adapter for integration and contract tests.Adapter: Google And Gemini`@webmcp-bridge/adapter-google` handles Google and Gemini fallback automation when native WebMCP is unavailable.Adapter: Weibo`@webmcp-bridge/adapter-weibo` supports Weibo when native browser WebMCP is unavailable.Adapter: X`@webmcp-bridge/adapter-x` supports X and Twitter when native WebMCP is unavailable.