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 トークンを提供する方法は複数あります。
MCP設定の構成（推奨） ：MCP設定ファイルでトークンを構成する
環境変数:
SOLARWINDS_API_TOKEN環境変数を設定するローカル .env ファイル (テスト用) : プロジェクト ルートに
SOLARWINDS_API_TOKEN=your-tokenで.envファイルを作成します。
ローカルテストでは次のことが可能です。
.env.exampleを.envにコピーし、トークンを追加します。サンプルスクリプトを実行します:
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 ログ
複数の認証方法をサポート