使用说明

项目简介

Ayd Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，专为 Ayd 监控工具设计。它允许大型语言模型 (LLM) 客户端通过 MCP 协议访问 Ayd 监控的服务的状态和日志信息。通过 Ayd Server，LLM 可以理解当前系统的健康状况，并基于监控数据进行更智能的决策和交互。

主要功能点

提供 Ayd 监控数据访问能力: LLM 可以通过调用工具获取 Ayd 监控的目标列表、状态概览、特定目标状态以及监控日志。
基于 MCP 协议: 采用标准的 MCP 协议与 LLM 客户端通信，易于集成到支持 MCP 的 LLM 应用中。
工具 (Tools) 注册和执行: 注册了一系列工具，如 'listTargets' (列出监控目标), 'getStatusOverview' (获取状态概览), 'getTargetStatus' (获取目标状态), 'readLog' (读取监控日志)，允许 LLM 按需调用这些工具获取监控信息。
JSON-RPC 通信: 使用 JSON-RPC 协议进行客户端和服务端之间的通信。

安装步骤

下载二进制文件: 访问 release page 下载适用于您操作系统的最新版本的 'mcp-ayd-server' 二进制文件。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令和参数才能连接到 Ayd Server。以下是一个配置示例，适用于 Claude Desktop 等 MCP 客户端：

{
  "mcpServers": {
    "ayd": {
      "command": "C:\\path\\to\\mcp-ayd-server.exe",  //  请替换为 mcp-ayd-server 可执行文件的实际路径
      "args": ["http://127.0.0.1:9000"]  //  AYD_URL：请替换为您的 Ayd 监控工具的 Web 访问地址。例如，如果 Ayd 运行在本地 9000 端口，则使用 "http://127.0.0.1:9000"
    }
  }
}

配置参数说明:

'server name': 'ayd' - 服务器名称，可以自定义，用于在客户端中标识该 MCP 服务器。
'command': 'C:\path\to\mcp-ayd-server.exe' - 必须修改。指向您下载的 'mcp-ayd-server.exe' 可执行文件的完整路径。
'args': '["http://127.0.0.1:9000"]' - 必须修改。包含一个参数，即 'AYD_URL'，指向您的 Ayd 监控工具的 Web 访问地址。请根据您的 Ayd 实际部署地址进行修改。

基本使用方法

启动 MCP 客户端: 配置完成后，启动您的 MCP 客户端应用 (例如 Claude Desktop)。
与助手对话: 在 LLM 客户端中，您可以向助手提问关于 Ayd 监控状态的问题。例如：
- "Ayd 监控了哪些目标？" (对应 'listTargets' 工具)
- "所有目标的监控状态如何？" (对应 'getStatusOverview' 工具)
- "URL 为 'http://example.com' 的目标状态是什么？" (对应 'getTargetStatus' 工具，需要将 'http://example.com' 替换为实际的监控目标 URL)
- "读取最近的监控日志。" (对应 'readLog' 工具，可以进一步指定查询条件、起始时间和结束时间)

LLM 客户端会根据您的问题，自动调用 Ayd Server 提供的工具获取信息，并结合上下文进行回答。

关键词