Argus MCP 服务器

关键词

Argus资源管理工具执行提示模板JSON-RPC

使用说明内容（Markdown格式）

  • 项目简介

    • Argus MCP 服务器是一套实现 MCP 协议的后端服务，专为在 AI 编码助手、IDE 等环境中向 LLM 客户端提供统一的上下文信息和外部功能调用能力而设计。它负责托管资源、注册工具、定义并渲染 Prompt 模板，以及通过 JSON-RPC/WebSocket/SSE 等传输协议与客户端进行交互。
    • 本仓库在实现中提供了对 LangGraph/MCP 的集成，以及与 Playwright、浏览器自动化相关工具的协作能力，目标是让 AI 助手在开发环境中直接调用这些工具、获取资源、执行自动化任务。

  • 主要功能点

    • MCP 核心能力
      • 资源管理：后台托管与访问资源，作为数据访问与上下文信息的来源。
      • 工具（Tools）注册与执行：LLM 可以通过 MCP 调用服务器暴露的外部功能，完成浏览器操作、测试执行等能力。
      • 提示模板（Prompts）：定义、渲染与管理可定制的 Prompt 模板，支持不同的交互模式。
      • JSON-RPC 通信：客户端通过标准的 JSON-RPC 请求/响应进行通信。
    • 会话与能力声明
      • 服务器端维护会话、声明自身能力，便于不同客户端对接与能力协商。
    • 多传输协议支持
      • 服务器设计目标支持 STDIO/SSE/WebSocket 等传输模式，满足不同 IDE/客户端的需求。
    • IDE 集成示例
      • 支持 Claude Code、Cursor 等 MCP 兼容 IDE 的连接与使用场景，示例包括 argus_health、argus_discover、argus_act、argus_test、argus_generate_test 等工具。

  • 安装步骤

    • 克隆仓库并进入项目目录
    • 安装依赖并在本地启动 MCP 服务器（具体命令在 README 的 MCP 集成部分有示例）
    • 根据你的开发环境选择合适的传输方案（如 SSE/WebSocket/StdIO），并在客户端进行对应的配置

  • 服务器配置（MCP 客户端需要的配置信息示例） 服务器名称：argus 启动命令（command）：npx 参数（args）：["-y", "mcp-remote", "https://argus-mcp.samuelvinay-kumar.workers.dev/sse"]

    配置说明：

    • serverName（argus）用于在 MCP 客户端的服务器列表中标识你要连接的 MCP 服务器。
    • command 与 args 指定了如何在本地或远程环境启动该 MCP 服务器进程。MCP 客户端不需要理解内部实现细节，只需知道该服务器的启动方式和连接地址即可。
    • 连接地址 https://argus-mcp.samuelvinay-kumar.workers.dev/sse 对应的是相应的 SSE 服务端点（示例地址，实际环境可替换为你部署的端点）。
    • 客户端在配置中通常只需要提供服务器名称、启动命令及参数，服务器实现者无需在客户端提供额外的代码。

  • 基本使用方法

    • IDE/CLI 配置后启动 MCP 服务器，确保服务器能成功连接到客户端并注册可用的工具与资源。
    • 在 IDE 中通过 MCP 设置选择 Argus 服务器，即可让 LLM 客户端调用 argus_health、argus_discover、argus_act、argus_test、argus_extract、argus_agent、argus_generate_test 等 Tools。
    • 通过提供的 Prompt 模板，LLM 可以获取所需上下文信息、执行外部操作、并在需要时返回测试结果、资源数据等。

  • 运行与调试

    • 根据项目实际部署环境，确保端口、网络策略、WebSocket/SSE 连接等是可用的。
    • 参考仓库中的 MCP 实现代码（src/mcp/langgraph_mcp.py、src/mcp/playwright_mcp.py 等）以了解更具体的实现细节与 API 接口。

  • 注意事项

    • MCP 服务实现应具备对请求的解析、响应的构造，以及对资源/工具/提示模板等的管理能力。
    • 与 IDE 的集成应提供清晰的错误处理、能力声明以及安全性注意点，避免将敏感信息暴露给模型。

关键词 Argus, 资源管理, 工具执行, 提示模板, JSON-RPC, 多传输协议

分类ID 6

服务器信息

访问项目