使用说明

• 项目简介
  • 这是一个基于 MCP 标准的服务器端实现，包含 Brave 系列 MCP 服务器与辅助组件，能够注册与执行资源、工具、Prompt 模板等能力，提供面向 LLM 客户端的上下文服务。支持本地文件工作区、联网搜索、PPT/文档生成等能力的工具集成，并通过多种传输协议与客户端进行 JSON-RPC 通信。
• 主要功能点
  • MCP 核心能力：注册 Resources、Tools、Prompts，按统一接口处理读取、调用、渲染等请求，并返回 JSON-RPC 响应。
  • 工具注册与执行：一套工具集合用于网页抓取、浏览器自动化、PPT/文档等工作流的能力暴露，支持本地/云端模型与第三方服务。
  • 资源与上下文管理：会话管理、上下文隔离、跨请求的上下文复用，确保 AI 调用外部能力时的稳定性与可追踪性。
  • 支持多传输协议：内置 Stdio、SSE/流式 HTTP、WebSocket 等传输方式，满足不同客户端接入场景。
  • 与 Brave/Search 等能力对接：提供 Brave API 及相关工具的示例实现，支持联网检索、图像/视频/新闻等多类型数据源。
• 安装步骤
  • 克隆仓库后，在根目录执行安装依赖（Node.js 环境要求 >= 18）。
  • 在 Brave Search MCP Server 相关子目录中安装依赖（如 brave-search-mcp-server、scrapeless-mcp-server 等）。
  • 构建/启动：
    • 桌面端启动（功能最完整，包含本地工作区、浏览器工具、PPT/ONLYOFFICE 集成等）参照仓库自述中的桌面端启动方式。
    • 如需使用 HTTP/WebSocket/SSE 传输，参考相应协议实现来启动 HTTP 传输服务。
• 服务器配置（供 MCP 客户端使用的启动信息，客户端至少需提供启动命令和参数）
  • 服务器名称：brave-search-mcp-server
  • 启动命令（command）：node
  • 启动参数（args）：dist/server.js
  • 启动说明：以上命令用于在本地或部署环境启动 MCP 服务器，默认通过标准输入输出（STDIO）传输与 MCP 客户端对接。若使用 HTTP/流式传输，请在部署时配置对应的传输入口并在环境变量中设定所需端点与密钥。
  • 额外说明：运行该服务器前需要配置 Brave API Key、必要的工具 API Key 等环境变量，且在客户端配置中需确保传输模式与服务端端口一致。
• 基本使用方法
  • 启动桌面端或 HTTP 服务器后，客户端通过指定的传输方式与 MCP 服务器建立连接，发送 JSON-RPC 请求以读取资源、调用工具、获取 Prompts 等。
  • 使用对话式工作流时，可以通过工具调用链路实现联网检索、页面抓取、PPT/文档生成等工作流，并通过审阅/修改差异的机制进行迭代优化。
  • 如需在本地进行调试，可使用桌面端的设置界面配置主模型 Key、联网搜索 Key、PPT 生图/编辑所需的各类 Key。