LibrAgent MCP 服务器端

关键词

智能代理工具执行会话隔离本地后端环境隔离

使用说明（Markdown）

  • 项目简介

    • LibrAgent 是一个本地自治式 AI 代理平台，内置多种工具（浏览器、工作区、知识库、计划等），并对 MCP（Model Context Protocol）提供 extensibility，允许外部 MCP 服务器接入并通过 JSON-RPC 风格的请求/响应进行交互。

  • 主要功能点

    • MCP 核心能力：提供资源管理、工具注册与执行、以及提示模板的渲染与管理，客户端通过 JSON-RPC 与服务器通信。
    • Built-in Tooling 与 External MCP 支持并存：内置工具直接在 Rust 层实现，外部 MCP 服务器通过 stdio/HTTP 进行通信。
    • 会话隔离与并发性：支持基于会话的代理管理，确保不同会话的工具执行、状态和上下文相互独立。
    • 安全与沙箱：包含对工具执行环境的安全控制、环境变量隔离、以及对文件系统访问的路径安全策略。
    • UI 与工具交互：提供 UI 内置服务、提示工具、错误引导等，帮助 LLM 客户端获得稳定、可预测的响应。

  • 安装步骤

    • 该仓库包含完整的后端实现与前端集成，推荐直接从源码构建：
      1. 克隆仓库并进入目录
      2. 根据系统环境安装依赖（Rust、Node、Wasmer/wasm 运行时等）
      3. 构建并运行本地应用，按 README 提供的 Quick Start 进行打包或开发调试
    • 由于仓库具备完整的服务端和客户端实现，直接编译运行即可启动 MCP 服务端框架以及内置的工具/代理管理逻辑。

  • 服务器配置（客户端所需信息，JSON 格式） 说明：MCP 客户端需要通过该配置了解如何启动外部 MCP 服务器并与之建立连接。以下信息请据仓库内容理解为示例描述，实际配置请以您的部署环境为准。

    • server name（服务器名称，用于标识 MCP 服务端）
    • transport（传输方式及参数，如 stdio、http）
    • command（外部 MCP 服务器可执行程序路径）
    • args（启动参数列表）
    • 需要的认证信息/元数据（如果有）

    举例描述（非代码块形式展示，方便直接阅读）：

    • server name: external-mcp-echo
    • transport: stdio
    • command: /usr/local/bin/external-mcp-echo
    • args: ["--listen", "tcp://127.0.0.1:12345", "--log-level", "debug"]
    • 说明：该外部 MCP 服务器通过标准输入/输出与 LibrAgent 通信，提供额外的工具与资源能力。

  • 基本使用方法

    • 启动与连接：在本地环境中启动 LibrAgent，配置外部 MCP 服务器后，客户端即可通过 MCP 的 JSON-RPC 请求向 LibrAgent 请求资源、调用工具、获取提示等。
    • 会话管理：通过会话标识实现多会话并发执行，确保不同会话之间的工具和上下文状态独立。
    • 安全性：系统在工具执行时对环境变量进行隔离，确保主机敏感信息不被外部 MCP 服务器窃取。
    • 调试与扩展：仓库提供内置与外部 MCP 服务器的组合模式，便于在本地快速扩展功能。

服务器信息

访问项目