使用说明

• 项目简介
  • 该仓库实现了“在浏览器内运行的 MCP 服务器”思路，将资源、工具、提示等上下文要素以 MCP 标准暴露给 LLM 客户端。核心能力包括：
    • 资源（Resources）托管与数据访问
    • 工具（Tools）注册与调用，支持外部功能执行
    • Prompt 模板渲染与上下文配置
    • JSON-RPC 形式的请求/响应通信与会话管理
    • 支持浏览器内 WASM 沙箱、OPFS 本地文件系统、以及对接外部 MCP 服务器
• 主要功能点
  • 基于 MCP 的 JSON-RPC 服务端实现（包括 initialize、initialized、tools/list、tools/call 等接口，以及对资源、Prompts 的占位实现）
  • 浏览器端执行核心 MCP 服务逻辑，MCP 服务暴露给前端 UI 与其他 Neo-MCP 客户端
  • WASM MCP Server（Rust/WASI P2）在浏览器沙箱中运行，并通过桥接层与浏览器 API 交互
  • 远程 MCP 服务器接入能力（OAuth PKCE、Bearer Key 等认证方式）
  • 面向前端的 Tool 转换与集成（将 MCP Tool 转换为前端可执行 Tool），以及 Task 管理与 UI TUI 组件
• 安装步骤
  • 运行环境准备
    • 浏览器环境用于前端展示；若要搭建本地开发环境，需在本地安装 Rust 1.83+、Node.js 20+，并具备 Docker（可选）
  • 构建与启动
    • 安装依赖：npm install
    • 构建全部组件：npm run build
    • 开发热重载：npm run dev
  • 运行说明
    • 该 MCP 服务器核心在浏览器中通过 Web Worker/WASM 沙箱承载，客户端通过标准 JSON-RPC 请求与之通信。前端提供完整的 MCP 工具链、资源管理与远程服务器接入能力。
• 服务器配置（给 MCP 客户端的配置信息，JSON 格式，注解说明）
  • server_name: AgentInBrowser-MCP
  • command: 启动浏览器内 MCP 服务的入口（浏览器内核，无实际外部端口暴露，运行于前端上下文）
  • args: []
  • comment: 该 MCP 服务器是在浏览器内运行的 MCP 服务，客户端通过前端提供的桥接接口进行通信。若要在客户端以外部进程形式连接此服务，请在客户端配置中使用浏览器适配的通讯通道（如内置桥接或端对端的消息通信）。
  • 额外信息：MCP 客户端的连接命令与参数会在其侧给出，仓库中提供了诸多命令接口（如 /mcp、/provider、/model、/files 等）用于管理与调用。
• 基本使用方法
  • 打开前端应用（该仓库的前端 UI），浏览器内 MCP 服务默认作为内置组件工作，无需外部后端。
  • 通过内置命令（如 /mcp、/provider、/model、/files 等）来管理资源、配置提供者与模型、以及连接远程 MCP 服务器。
  • 如需对接外部 MCP 服务器，使用远程 MCP 功能（OAuth PKCE、Bearer token、或 API Key），并在 UI/命令中完成注册、认证与连接。
  • 开发者可通过浏览器的开发者工具查看日志，调试 MCP 请求/响应和工具执行过程。
• 重要说明
  • MCP 服务在浏览器中运行，属于前端能力边界内的实现，本质为“在浏览器沙箱中的 MCP 服务端实现”。这是一个全栈式架构示例，集成了 WASM MCP Server、OPFS、以及前端 UI 的完整栈。
  • 若需二次开发，请关注 runtime（WASM/MCP 服务器实现）、frontend（UI、桥接、工具转换、远程 MCP 集成）以及 mcp Registry 的模块化设计。