SolarWinds ログ MCP サーバー

SolarWinds Observability ログにアクセスして視覚化するための Model Context Protocol (MCP) サーバー。

注記 -

このサーバーは現在、構造化データ検索をサポートしていないため不完全です（REST APIの制限でしょうか）。APIエンドポイント呼び出しで使用するためにデータセンターの指定も必要かどうかは不明です。時間があれば、どちらも対応する予定です（実際の業務上の問題で必要だったので、まずはそちらを修正する必要があります）。

ツール

検索ログ

オプションのフィルタリングを使用してSolarWinds Observabilityログを検索

• フィルター、時間範囲、ページ区切りオプションなどの検索パラメータを取得します

• タイムスタンプ、ホスト名、メッセージを含むフォーマットされたログエントリを返します

• グループ、エンティティなどによる高度なフィルタリングをサポート

• デフォルトの検索範囲は過去24時間です

ログを視覚化する

ログイベントのヒストグラムJSONレスポンスを生成する

• クロードとキャンバス表現用にフォーマット

• 設定可能な時間間隔（分、時間、日）

• UTCまたはローカルタイムゾーンをサポート

• カスタマイズ可能なクエリフィルターと時間範囲

• デフォルトの視覚化範囲は過去24時間です

リソース

SolarWinds ログ検索

• URI テンプレート: solarwinds://{query}/search

• 指定されたクエリに一致するログエントリを返します

• 例: solarwinds://error/search

Related MCP server: Weather Query MCP Server

インストール

オプションで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"]
    }
  }
}

クロードデスクトップ向け

適切な設定ファイルに追加します:

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 サーバーでは、SolarWinds Observability API で認証するために API トークンが必要です。

設定方法

API トークンを提供する方法は複数あります。

1. MCP設定の構成（推奨） ：MCP設定ファイルでトークンを構成する

2. 環境変数: SOLARWINDS_API_TOKEN環境変数を設定する

3. ローカル .env ファイル (テスト用) : プロジェクト ルートにSOLARWINDS_API_TOKEN=your-tokenで.envファイルを作成します。

ローカルテストでは次のことが可能です。

1. .env.exampleを.envにコピーし、トークンを追加します。

2. サンプルスクリプトを実行します: node examples/local-test.js

ツールの使用例

検索ログ

基本検索:

{
  "filter": "error"
}

時間範囲とページ区切りによる高度な検索:

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

ログを視覚化する

基本ヒストグラム（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
}

クロード視覚化（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 が提供され、次の操作を実行できます。

• すべてのMCPメッセージを表示

• リクエスト/レスポンスペイロードを検査する

• ツールをインタラクティブにテストする

• サーバーの状態を監視する

MCP フレームワークを使用しないローカルテストの場合:

# Create a .env file with your token
cp .env.example .env
# Edit .env to add your token
# Run the example script
node examples/local-test.js

技術的な詳細

• TypeScriptとMCP SDKを使用して構築

• API通信にaxiosを使用する

• 時間範囲の ISO 8601 日付形式をサポート

• ログの視覚化のためのASCIIヒストグラムを生成します

• デフォルトの検索範囲: 過去24時間

• デフォルトのページサイズ: 50 ログ

• 複数の認証方法をサポート