JinDaGe - mcp-solarwinds MCP Details

article

README

🚀 SolarWinds日志MCP服务器

SolarWinds日志MCP服务器是一个专为SolarWinds日志设计的模型上下文协议（MCP）服务器，它能让用户轻松访问和可视化日志数据，极大提升了日志分析的效率。

🚀 快速开始

SolarWinds日志MCP服务器允许用户搜索、分析和可视化SolarWinds生成的日志数据。借助该服务器，用户可高效处理日志信息。

✨ 主要特性

功能多样：支持用户搜索、分析和可视化SolarWinds生成的日志数据。
认证灵活：支持多种认证方式，保障系统安全。
可视化强：自动生成ASCII直方图进行日志可视化，直观展示日志情况。
范围默认：默认搜索范围为过去24小时，方便用户快速获取近期日志。
分页合理：每页默认显示50条日志，优化查看体验。

📦 安装指南

安装依赖：
```
npm install
```
构建服务器：
```
npm run build
```

💻 使用示例

基础用法

环境变量配置示例

cp .env.example .env
# 修改.env文件并添加你的token

运行测试脚本

node examples/local-test.js

高级用法

搜索日志

# 调用search_logs工具搜索特定条件的日志
# 示例：搜索2025年3月1日到3月5日包含"error"的日志，每页显示100条，搜索方向为向后
# 这里假设已经有调用search_logs的脚本，实际使用时根据具体情况调整
node search_logs.js --filter "error" --startTime "2025-03-01T00:00:00Z" --endTime "2025-03-05T23:59:59Z" --pageSize 100 --direction "backward"

可视化日志

# 调用visualize_logs工具生成指定时间范围内的日志直方图
# 示例：生成2025年3月1日到3月5日包含"error"的日志直方图，时间间隔为小时，使用UTC时间，输出格式为json
# 这里假设已经有调用visualize_logs的脚本，实际使用时根据具体情况调整
node visualize_logs.js --filter "error" --startTime "2025-03-01T00:00:00Z" --endTime "2025-03-05T23:59:59Z" --interval "hour" --use_utc true --format "json"

📚 详细文档

工具说明

search_logs（搜索日志）

用于在指定时间范围内搜索特定条件的日志。 | 参数名称 | 类型 | 描述 | 示例值 | | ---- | ---- | ---- | ---- | | filter | string | 日志过滤条件 | "error" | | startTime | string | 起始时间（ISO 8601格式） | "2025-03-01T00:00:00Z" | | endTime | string | 结束时间 | "2025-03-05T23:59:59Z" | | pageSize | number | 每页显示条数 | 100 | | direction | string | 搜索方向（forward/backward） | "backward" |

visualize_logs（可视化日志）

用于生成指定时间范围内的日志直方图。 | 参数名称 | 类型 | 描述 | 示例值 | | ---- | ---- | ---- | ---- | | filter | string | 日志过滤条件 | "error" | | startTime | string | 起始时间（ISO 8601格式） | "2025-03-01T00:00:00Z" | | endTime | string | 结束时间 | "2025-03-05T23:59:59Z" | | interval | string | 时间间隔（minute/hour/day） | "hour" | | use_utc | boolean | 是否使用UTC时间 | true | | format | string | 输出格式（ascii/json） | "json" |

资源说明

日志接口：/logs
可视化接口：/visualize

配置方法

环境变量配置

创建一个.env文件，添加以下内容：

TOKEN=your_token_here

示例配置

{
  "filter": "error",
  "startTime": "2025-03-01T00:00:00Z",
  "endTime": "2025-03-05T23:59:59Z"
}

调试说明

使用MCP Inspector工具进行调试：

npm run debug:inspector

访问提供的URL，即可查看：

所有MCP消息
请求/响应数据包
交互式测试工具
服务器状态监控

🔧 技术细节

技术栈：基于TypeScript和MCP SDK开发，保证系统的高效性和可维护性。
依赖库：使用axios进行API通信，确保数据交互的稳定。
时间格式：支持ISO 8601日期格式，方便统一时间处理。
日志可视化：生成ASCII直方图或JSON格式输出，满足不同的可视化需求。

mcp-solarwinds