AgentTel MCP 服务器

关键词

JSON-RPC工具执行资源与健康上下文自动化诊断协议接口

使用说明（摘要）

  • 项目简介
    • AgentTel 的 MCP 服务器模块实现了一个 JSON-RPC 风格的服务端接口，旨在将监控数据、健康信息、 incidents、 remediation 等功能暴露给 AI agent 使用。实现了工具注册、工具执行、工具列表、以及文档页面等核心 MCP 功能，供 MCP 客户端发起请求并获取结构化响应。
  • 主要功能点
    • 通过 /mcp 提供 JSON-RPC 2.0 风格的接口，支持 initialize、tools/list、tools/call 三类请求。
    • umožňuje 注册工具并在工具调用时返回结构化的文本/文本段落形式的结果。
    • 提供 /mcp/docs 的 HTML 文档页，展示已注册工具的说明、参数、示例请求等。
    • 提供健康检查 /health，用于监控 MCP 服务器状态。
    • 服务器端与 AgentTel 的其它组件协同工作，支持将健康、依赖、SLO、趋势、告警等信息通过工具查询或回传给 LLM。
  • 安装步骤
    • 通过构建产物获取包含 MCP 服务器实现的可执行包（示例：agenttel-mcp-server.jar）。
    • 启动服务器（默认端口 8081，具体端口可在启动参数中修改）。
    • 服务器启动后，客户端可通过 HTTP 请求访问 http://<host>:8081/mcp。
  • 服务器配置（MCP 客户端需要的启动参数）
    • 说明：MCP 客户端需要的不是代码，而是连接到 MCP 服务器的信息。下面给出一个示意性的配置 JSON，描述服务器名称、启动命令与参数。请将实际的服务器可执行包、端口等信息替换为你的环境参数。
    • 配置示例（JSON，供 MCP 客户端读取与记录）: { "server_name": "agenttel-mcp-server", "command": "java", "args": [ "-jar", "agenttel-mcp-server.jar", "--port=8081" ], "notes": "若需要修改端口，请在启动参数中设置 --port=<端口号>；实际 jar 名称请替换为构建产出的文件名。服务器将暴露在 http://<host>:8081/mcp" }
  • 基本使用方法
    • 客户端通过 JSON-RPC 调用 initialize 获取初始能力信息，然后通过 tools/list 获取可用工具清单，通过 tools/call 按名称执行具体工具并获取文本结果。
    • 浏览文档页：通过 GET /mcp/docs 查看已注册工具的详细说明、输入参数和示例请求。
    • 通过 /health 进行运行状况检查，以确保 MCP 服务器可用。
    • 集成要点：MCP 客户端在与服务器对接时需要遵循 JSON-RPC 2.0 的规范格式，服务端将返回标准的 jsonrpc、id、result 或 error 字段。

服务器信息

访问项目