SolarWinds Logs MCP 服务器

一个用于访问和可视化 SolarWinds Observability 日志的模型上下文协议 (MCP) 服务器。

注意 -

此服务器目前不完整，因为它不支持结构化数据搜索（REST API 的限制？）。我不确定它是否还需要接受一个数据中心，以便在 API 端点调用中使用。将在有时间时解决这两个问题（因为实际工作需要，必须先解决这个问题）。

工具

search_logs

使用可选的过滤条件搜索 SolarWinds Observability 日志

• 接受搜索参数，包括过滤器、时间范围和分页选项
• 返回带有时间戳、主机名和消息的格式化日志条目
• 支持按组、实体等进行高级过滤
• 默认搜索范围是最近 24 小时

visualize_logs

生成日志事件的直方图 JSON 响应

• 格式化为 Claude 和画布表示
• 可配置的时间间隔（分钟、小时、天）
• 支持 UTC 或本地时区
• 可自定义的查询过滤器和时间范围
• 默认可视化范围是最近 24 小时

资源

SolarWinds 日志搜索

• URI 模板：solarwinds://{query}/search
• 返回与指定查询匹配的日志条目
• 示例：solarwinds://error/search

安装

可以选择从 npm 安装：

npm install -g mcp-solarwinds

或者从源代码克隆和构建：

git clone https://github.com/@jakenuts/mcp-solarwinds.git
cd mcp-solarwinds
npm install
npm run build

或者直接在配置中使用 npx

对于 Cline VSCode 扩展

添加到 %APPDATA%/Code - Insiders/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json：

{
  "mcpServers": {
    "solarwinds": {
      "command": "npx",
      "args": ["-y", "mcp-solarwinds"],
      "env": {
        "SOLARWINDS_API_TOKEN": "your-api-token"
      },
      "autoApprove": ["search_logs", "visualize_logs"]
    }
  }
}

对于 Claude Desktop

添加到相应的配置文件：

Windows: %APPDATA%/Claude/claude_desktop_config.json MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "solarwinds": {
      "command": "npx",
      "args": ["-y", "mcp-solarwinds"],
      "env": {
        "SOLARWINDS_API_TOKEN": "your-api-token"
      }
    }
  }
}

特殊 Windows 配置

如果在 Windows 上遇到 ENOENT spawn npx 问题，请使用此替代配置，该配置指定完整路径：

{
  "mcpServers": {
    "solarwinds": {
      "command": "C:\\Users\\[username]\\AppData\\Roaming\\nvm\\[node-version]\\node.exe",
      "args": [
        "C:\\Users\\[username]\\AppData\\Roaming\\npm\\node_modules\\npm\\bin\\npx-cli.js",
        "-y",
        "mcp-solarwinds"
      ],
      "env": {
        "SOLARWINDS_API_TOKEN": "your-api-token"
      }
    }
  }
}

配置

SolarWinds Observability MCP 服务器需要 API 令牌才能通过 SolarWinds Observability API 进行身份验证。

配置方法

有多种方法可以提供 API 令牌：

1. MCP 设置配置（推荐）：在您的 MCP 设置文件中配置令牌
2. 环境变量：设置 SOLARWINDS_API_TOKEN 环境变量
3. 本地 .env 文件（用于测试）：在项目根目录中创建一个 .env 文件，其中包含 SOLARWINDS_API_TOKEN=your-token

对于本地测试，您可以：

1. 将 .env.example 复制到 .env 并添加您的令牌
2. 运行示例脚本：node examples/local-test.js

工具使用示例

search_logs

基本搜索：

{
  "filter": "error"
}

具有时间范围和分页的高级搜索：

{
  "filter": "error",
  "entityId": "web-server",
  "startTime": "2025-03-01T00:00:00Z",
  "endTime": "2025-03-05T23:59:59Z",
  "pageSize": 100,
  "direction": "backward"
}

visualize_logs

基本直方图（ASCII 图表）：

{
  "filter": "error",
  "interval": "hour"
}

高级可视化（ASCII 图表）：

{
  "filter": "error",
  "entityId": "web-server",
  "startTime": "2025-03-01T00:00:00Z",
  "endTime": "2025-03-05T23:59:59Z",
  "interval": "day",
  "use_utc": true
}

Claude 可视化（JSON 格式）：

{
  "filter": "error",
  "interval": "hour",
  "format": "json"
}

JSON 格式返回 Claude 可以可视化为图表的数据：

{
  "timeRanges": ["12:02", "12:03", "12:04", "12:05", "12:06", "12:07", "12:08", "12:09"],
  "counts": [261, 47, 48, 48, 31, 262, 270, 33],
  "total": 1000,
  "queryParams": {
    "query": "error",
    "startTime": "2025-03-05T00:00:00.000Z",
    "endTime": "2025-03-05T23:59:59.000Z"
  }
}

开发

安装依赖项：

npm install

构建服务器：

npm run build

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 MCP Inspector 提供了有用的调试工具：

npm run debug:inspector

这将提供一个 URL 以在您的浏览器中访问 Inspector，您可以在其中：

• 查看所有 MCP 消息
• 检查请求/响应有效负载
• 交互式测试工具
• 监控服务器状态

对于没有 MCP 框架的本地测试：

# 创建一个包含您的令牌的 .env 文件
cp .env.example .env
# 编辑 .env 以添加您的令牌
# 运行示例脚本
node examples/local-test.js

技术细节

• 使用 TypeScript 和 MCP SDK 构建
• 使用 axios 进行 API 通信
• 支持 ISO 8601 日期格式的时间范围
• 生成用于日志可视化的 ASCII 直方图
• 默认搜索范围：最近 24 小时
• 默认页面大小：50 个日志
• 支持多种身份验证方法