BrowseAI MCP Server

关键词

上下文服务工具执行网页检索证据背书OpenRouter

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个 MCP 服务器，旨在以标准化的 JSON-RPC 风格向 LLM 客户端提供资源、工具和提示模板等能力，方便将网页检索、页面解析、知识提取和证据-backed 回答等能力接入到大语言模型的工作流中。

  • 主要功能点

    • MCP 服务器核心：基于 @modelcontextprotocol/sdk 的 MCP 服务端实现，支持 stdio 传输（当前实现为 StdioServerTransport），可向客户端暴露工具入口并处理请求/响应。
    • 工具注册与执行：实现了若干 MCP Tool（如 browse_search、browse_open、browse_extract、browse_answer、browse_compare），支持读取输入、执行外部请求并返回文本内容。
    • 内容与证据能力：对网页进行检索、打开、提取，并通过后端逻辑聚合出带来源、可信度和跟踪信息的回答与证据图谱。
    • BYOK 与 API 两种模式：允许使用 BrowseAI API Key（BYOK）或自行提供 Tavily/OpenRouter/API 组合实现底层请求，具备缓存、权限校验和限流等机制。
    • 会话与安全：实现了对 API Key、JWT/用户鉴权、访问控制及速率限制的处理逻辑，便于集成到多用户场景。

  • 安装步骤

    • 安装依赖并准备运行环境。
    • 启动 MCP 服务器：通常通过 MCP 客户端命令连接该服务器（具体命令见下方的配置说明）。
    • 若需要，请按仓库提供的“自建/自有密钥模式”配置环境变量，并通过 MCP 客户端将服务器加入到配置中。

  • 服务器配置（供 MCP 客户端使用的配置信息，JSON 格式，说明与注释在字段后给出） { "server": "browse-ai", "command": "npx", "args": ["-y", "browse-ai"], "env": { "SERP_API_KEY": "YOUR_TAVILY_OR_SIMILAR_API_KEY", "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY" } // 注释说明： // - server: MCP 客户端将连接的服务器名称，与代码中创建的服务器名称一致，便于识别与注册。 // - command / args: 启动服务器的命令及参数，当前实现通过 npx browse-ai 启动 MCP 服务器。 // - env: 运行时所需的关键证书/密钥对（若使用 BYOK 模式请提供 Tavily/OpenRouter 等密钥；若使用 BrowseAI API Key，请将 SERP_API_KEY/OPENROUTER_API_KEY 设为相应密钥或留空让 BYOK 模式生效）。 }

  • 基本使用方法

    • 通过 MCP 客户端（如 Claude Desktop、Cursor、Windsurf 等）配置，使用上述服务器配置将浏览能力、挖掘能力等工具接入到对话流程中。
    • 客户端向该 MCP 服务器发送请求（如调用 browse_search、browse_open、browse_extract、browse_answer、browse_compare 等工具），服务器返回符合 MCP 规范的 JSON-RPC 响应和/或文本内容。
    • 如需自行运行，请在具有 Node.js 环境的机器上执行上述启动命令，并确保环境变量正确设置。

服务器信息

访问项目