agnt

使用说明（简要概览）

• 项目简介

  • agnt 是一个面向 AI 编码助手的后端服务器实现，遵循 MCP（Model Context Protocol）标准。它通过一个 MCP 服务器向客户端提供资源访问、工具执行、以及 Prompts 渲染等能力，支持通过 JSON-RPC 进行通信。核心目标是为 LLM 客户端提供可扩展、可安全管理的上下文服务。

• 主要功能点

  • MCP 服务器实现与通信
    • 使用 MCP 标准的 Server、Tools、Transport（当前为 StdIO/命令行传输）实现对外暴露的 API。
  • 资源、工具、Prompts 的管理与执行
    • 提供处理资源、注册并执行工具、以及渲染 Prompt 模板的能力，便于 LLM 客户端获取数据、执行外部功能、以及获取预设的对话模版。
  • 会话与状态管理
    • 拥有会话注册、心跳、自动启动、以及对多客户端的持久化状态管理能力。
  • 容器化与跨平台支持
    • 针对 Unix/Windows 提供了跨平台实现，包含 PTY 封装、Overlay、代理、以及多种开发者工具的集成。
  • 插件化工具集
    • 内置大量 MCP Tool（如 detect、run、proc、proxy、proxylog、currentpage、daemon、tunnel、snapshot、automation、session 等），支持通过 MCP 进行远程控制和查询。

• 安装步骤

  • 获取源码后，按照组内的构建方式进行编译：
    • 需要 Go 1.24+ 或等效环境。
    • 常见构建命令：在仓库根目录执行 make build，或直接构建特定命令入口，如 go build ./cmd/agnt。
  • 运行方式
    • 以 MCP 服务器模式运行：使用 agnt mcp（或 agnt serve 等相关子命令）启动 MCP 服务。
    • MCP 客户端需要的启动信息示例请参考仓库中的 README 配置片段，示例如下所述。

• 服务器配置（示例说明）

  • MCP 客户端要连接的服务器需要配置启动命令和参数，示例配置如下（请按实际环境替换路径与参数）：
  • 示例配置要素（JSON，供 MCP 客户端读取配置，描述服务器名称、启动命令及参数）：
  • 服务器名称：agnt 命令与参数：{"command": "agnt", "args": ["mcp"]}

  说明：

  • 该配置用于 MCP 客户端初始化时指定要启动的 MCP 服务器进程及其参数。agnt 在 MCP 模式下，通过 agnt 命令及 mcp 子命令输出 MCP 服务，客户端可通过 JSON-RPC 调用获取资源、执行工具、渲染 Prompts 等能力。
  • 实际中请将上述信息嵌入到 MCP 客户端的 mcpServers 字段中，以便在需要时自动连接并维持会话。

• 基本使用方法

  • 启动并连接 MCP 客户端
    • 启动 agnt 的 MCP 服务器实例（通过命令行执行 agnt mcp）
    • 在 MCP 客户端配置中指定 agnt 的启动命令与参数（如上示例所示）
  • 使用 MCP Tool 进行资源/工具操作
    • 通过 MCP 客户端调用注册在 agnt 上的工具（如 detect、run、proc、proxy 等），实现对浏览器代理、进程管理、日志查询等能力的远程调用
  • 使用 Prompts 与上下文
    • 通过 agnt 提供的提示模板（Prompts）对 LLM 进行上下文注入，帮助提升对话质量与任务完成率