使用说明（Markdown 格式）

• 项目简介
  • 本仓库实现了一个基于 MCP 的服务器端，面向“观测”场景。通过注册多个适配器提供的工具（如 Prometheus、Grafana、Loki、Jaeger 等），向客户端（LLM）暴露统一的工具调用接口，同时支持以标准化的方式读取资源、执行工具及渲染提示模板。服务器通过标准的 MCP 请求/响应模型与客户端进行通信，支持 STDIO 传输。
• 主要功能点
  • MCP 服务器核心能力：处理 MCP 的工具列表查询（ListTools 等请求）和调用工具（CallTool 等请求），返回符合 MCP 约定的响应。
  • 资源与工具管理：从多个观察领域适配器汇总工具定义，提供一致的输入参数结构。
  • 多适配器集成：Prometheus、Grafana、Loki、Jaeger 等适配器示例，便于扩展新工具。
  • 标准通信与传输：通过 STDIO 传输方式实现与客户端的 JSON-RPC 风格通信，便于嵌入式或管道化使用场景。
  • 路线清晰的扩展点：注释指出可实现的适配器扩展点，便于后续接入更多观测系统。
• 安装步骤
  • 安装 Node.js（建议版本 18+）。
  • 安装依赖：在仓库根目录执行 npm install（若提供 package.json，会自动安装依赖）。
  • 启动服务器（Node 版本示例）：node index.js
  • 备用入口（ReScript 版本入口）：node main.js（如需要通过 ReScript 编译产物运行，请确保相关依赖和产物就绪）
• 服务器配置（供 MCP 客户端参考，不需要该配置内容在客户端执行）
  • 服务器名称：poly-observability-mcp
  • 启动命令：node
  • 启动参数：index.js
  • 传输方式：stdio 说明：MCP 客户端通常需要知道如何启动服务器并连接，以上信息用于生成客户端的连接配置。实际使用时，客户端会依据该配置通过子进程启动服务器并通过标准输入/输出进行通信。
• 基本使用方法
  • 客户端通过 MCP 标准请求，向服务器请求工具列表，服务器返回可用工具及描述。
  • 客户端选择工具并传入参数，服务器执行对应工具处理并返回结果内容（通常以文本形式呈现结果）。
  • 如需扩展，请实现新的适配器并将工具注册到 MCP 服务器，以便客户端可以调用新工具。