{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ccpqfsrd5x65","handle":"browse-mcp-proxy","url":"https://wellknown.network/agents/browse-mcp-proxy","links":{"self":"https://wellknown.network/agents/browse-mcp-proxy/record.json","html":"https://wellknown.network/agents/browse-mcp-proxy","markdown":"https://wellknown.network/agents/browse-mcp-proxy/record.md","api":"https://wellknown.network/api/v1/agents/browse-mcp-proxy","status":"https://wellknown.network/api/v1/agents/browse-mcp-proxy/status","claim":"https://wellknown.network/agents/browse-mcp-proxy/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/browse-mcp-proxy/claim.json","badge":"https://wellknown.network/agents/browse-mcp-proxy/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/browse-mcp-proxy/history","tools":"https://wellknown.network/api/v1/agents/browse-mcp-proxy/tools"},"ard":{"identifier":"urn:air::server:browse-mcp-proxy","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"browse-mcp-proxy","summary":"A proxy server for MCP Inspector that enables browser-based connections to MCP servers.","description":"# Browse MCP Proxy\n\nA proxy server that enables browser-based applications to connect to MCP (Model Context Protocol) servers. This proxy handles CORS, session management, and transport type conversion.\n\n## Why This Proxy?\n\nBrowser-based applications face several challenges when connecting to MCP servers:\n\n1. **CORS Restrictions**: Browsers enforce Same-Origin Policy, preventing direct connections to MCP servers on different origins.\n\n2. **Session Management**: MCP's Streamable HTTP transport requires session IDs that browsers can't automatically manage across requests.\n\n3. **STDIO Transport**: Browser JavaScript cannot spawn local processes, but this proxy can bridge that gap.\n\n## Architecture\n\n```\n┌─────────────────┐\n│  Browser/Tauri  │  (Inspector UI)\n│  Frontend App   │\n└────────┬────────┘\n         │ 1. HTTP requests (same-origin or CORS-allowed)\n         │ 2. X-MCP-Proxy-Auth header for security\n         ↓\n┌─────────────────┐\n│  MCP Proxy      │  (this server)\n│  Server         │  ┌──────────────────────┐\n│                 │  │ Session Management   │\n│  • CORS enabled │  │ proxy_id → server_id │\n│  • Auth token   │←→│ • Target URL         │\n│  • Transports   │  │ • Custom headers     │\n│                 │  └──────────────────────┘\n└────────┬────────┘\n         │ 3. Forwards requests with proper session handling\n         │ 4. Supports STDIO, SSE, and HTTP transports\n         ↓\n┌─────────────────┐\n│  Target MCP     │  (any MCP server)\n│  Server         │\n└─────────────────┘\n```\n\n## Installation\n\n```bash\n# Using pip\npip install browse-mcp-proxy\n\n# Using poetry\npoetry add browse-mcp-proxy\n\n# From source\ncd backend/browse-mcp-proxy\npoetry install\n```\n\n## Usage\n\n### Start the Proxy Server\n\n```bash\n# Basic usage\nbrowse-mcp-proxy serve\n\n# Custom port\nbrowse-mcp-proxy serve --port 6277\n\n# With auto-generated auth token and browser opening\nbrowse-mcp-proxy serve --open\n\n# Disable auth (development only!)\nbrowse-mcp-proxy serve --no-auth\n\n# With custom auth token\nbrowse-m…","publisher":{"name":"Xueyuan Lin","url":null},"homepage":"https://github.com/LinXueyuanStdio/browse-mcp","repository":"https://github.com/LinXueyuanStdio/browse-mcp","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["mcp","proxy","inspector","browser","websocket"],"pricing":null,"endpoints":[{"url":"pypi:browse-mcp-proxy","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"infra.browser-automation","name":"Browser Automation","confidence":1,"provenance":"declared"}],"categories":["infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"browse-mcp-proxy","registry":"pypi","observedAt":"2026-11-02T23:25:15.787Z","publishedAt":"2026-02-04T15:58:10.431786Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"browse-mcp-proxy","url":"https://pypi.org/project/browse-mcp-proxy/","firstSeenAt":"2026-09-09T10:27:53.111Z","fetchedAt":"2026-11-02T23:23:04.804Z","normalizedAt":"2026-11-02T23:23:04.804Z"}]},"firstSeenAt":"2026-09-09T10:27:53.111Z","updatedAt":"2026-11-02T23:25:15.787Z"}