使用说明

• 项目简介

  • 这是一个完整的 MCP（Model Context Protocol）服务器实现，围绕“Agent Toolbox”工具集合构建，可供大语言模型（LLM）通过 MCP 客户端调用服务器上的工具。服务器支持通过多种传输方式（如 STDIO、SSE）与客户端通信，具备工具注册、执行、会话管理、能力声明等 MCP 要素。

• 主要功能点

  • 注册并暴露 13 个工具接口：
    • search、extract、screenshot、weather、finance、validate_email、translate、geoip、news、whois、dns、pdf_extract、qr。
  • 每个工具定义明确的输入参数和输出结构，处理请求并返回规范化的 JSON-RPC 响应。
  • 支持两种传输方式：
    • STDIO（通过命令行与客户端的标准输入输出通信，适用于 Claude Desktop/Cursor/Windsurf 的传统集成场景）。
    • SSE（基于服务器推送的事件流更实时地处理请求）。
  • 会话管理与统计：
    • 基于使用记录的月度限额、端点使用分解、每日趋势、响应时间等指标实现按账户的调用控制。
  • 安全性与可扩展性：
    • 支持 API Key 的授权与配额管理，具备错误处理、限流和缓存等机制，具备可扩展性以便接入更多工具。

• 安装步骤

  • 安装 MCP 服务端（示例命令）：
    • 全局安装：npm install -g agent-toolbox-mcp
  • 启动方式（两种入口之一，具体取决于你要使用的传输协议）：
    • STDIO 启动：agent-toolbox-mcp
    • SSE 启动：按工具提供的 SSE 启动方式启动，并监听 /sse 与 /messages 路径
  • 服务器启动后，CLI/进程将对外暴露 MCP 服务端口及通信入口，供 MCP 客户端连接。

• 服务器配置（MCP 客户端用，供参考，不需要在 MCP 客户端做成代码）

  • 配置名称：agent-toolbox
  • server name: agent-toolbox
  • command: agent-toolbox-mcp
  • args: []（若需要特定传输模式或参数，可在此处添加）
  • 说明：MCP 客户端连接配置通常包含 server name、command、args 等，用于在客户端启动并连接到 MCP 服务器。由于 MCP 客户端不需要对服务器端的内部实现细节做修改，上述 JSON 描述用于文档参考。

  服务器端对外暴露的 MCP 端点示例（文本描述，不作为代码块展示）：

  • 以 STDIO 方式运行时，客户端通过标准输入输出与服务器进行请求/响应的 JSON-RPC 交互。
  • 以 SSE 方式运行时，客户端通过 /sse 路径建立事件流连接并通过 /messages 发送/接收请求。

• 基本使用方法（简明操作流程）

  • 客户端启动后，发送一个包含工具名称与输入参数的 JSON-RPC 请求到 MCP 服务器，例如调用 search 工具。
  • MCP 服务器解析请求、匹配注册的工具、执行对应的处理逻辑，返回带有 content、元数据的 JSON-RPC 响应。
  • 如遇错误，服务器会返回标准化的错误信息，便于上层 LLM 或调用方进行处理和重试。

• 重要注意

  • 该仓库实现了完整的 MCP 服务器端逻辑，包含多工具注册、输入输出定义、传输适配（STDIO/SSE）以及基础的会话与使用统计能力。请在合规环境中测试与部署，确保环境变量与依赖已正确配置。