MCP Server for Logz.io

Logz.io 用 MCP サーバー

Claude などの AI アシスタントが Logz.io のログ管理プラットフォームを利用できるようにする、オープンソースの Model Context Protocol（MCP）サーバーです。シンプルなログ検索、Lucene クエリ検索、Logz.io からの基本的な統計情報の取得に使えるツールが含まれています。

🚀 クイックスタート

Claude／Cursor などの設定ファイルに以下を追加します。

{
  "mcpServers": {
    
    # other servers ...
    
    "logzio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-logzio", 
        "apiKey", "YOUR_LOGZIO_API_KEY"
      ]
    }
  }
}

デフォルトのリージョンは US です。他のリージョンの場合は、以下を使用します。

{
  "mcpServers": {
    
    # other servers ...
    
    "logzio": {
      "command": "npx", 
      "args": [
        "-y",
        "mcp-server-logzio",
        "apiKey", "YOUR_LOGZIO_API_KEY",
        "region", "eu" # add this for example
      ]
    }
  }
}

🛠️ 詳細設定

コマンドライン引数

引数	説明	デフォルト	必須
apiKey <key>	Logz.io API キー	-	はい
region <region>	Logz.io のリージョン（us、us-west、eu、ca、au、uk）	us	いいえ
logzioUrl <url>	カスタム Logz.io API URL（リージョンより優先）	-	いいえ
--timeout <ms>	リクエストのタイムアウト	30000	いいえ
--retry-attempts <num>	リトライ回数	3	いいえ
--max-results <num>	クエリごとの最大結果数	1000	いいえ

対応リージョン

サーバーはリージョンコードを対応する Logz.io API エンドポイントに自動的に割り当てます。

リージョンコード	説明	API エンドポイント
us	米国東部（デフォルト）	https://api.logz.io
us-west	米国西部	https://api-wa.logz.io
eu	ヨーロッパ	https://api-eu.logz.io
ca	カナダ	https://api-ca.logz.io
au	オーストラリア	https://api-au.logz.io
uk	英国	https://api-uk.logz.io

リージョンの確認方法：Logz.io アカウントにログインし、ブラウザーの URL を確認してください。

• https://app.logz.io → リージョン us を使用
• https://app-eu.logz.io → リージョン eu を使用
• https://app-ca.logz.io → リージョン ca を使用
• など

🔧 利用可能なツール

エージェントには以下のツールが表示されます。

search_logs

シンプルなクエリとフィルターでログを検索します。

パラメーター：

• query（必須）：検索クエリ文字列
• timeRange：時間範囲（1h、6h、12h、24h、3d、7d、30d）
• from／to：カスタム時間範囲（ISO 8601）
• logType：ログタイプでフィルター
• severity：重大度レベルでフィルター
• limit：最大結果数（1～1000）
• sort：並べ替え順（asc／desc）

query_logs

Lucene クエリを使った高度な検索を行います。

パラメーター：

• luceneQuery（必須）：Lucene クエリ文字列
• from／to：時間範囲（ISO 8601）
• size：最大結果数（1～1000）
• sort：並べ替え順（asc／desc）

get_log_stats

集計されたログ統計情報とメトリクスを取得します。

パラメーター：

• timeRange：時間範囲（1h、6h、12h、24h、3d、7d、30d）
• from／to：カスタム時間範囲（ISO 8601）
• groupBy：グループ化するフィールド

🏗️ 開発（コードを変更する場合）

前提条件

• Node.js 24.14.0+
• TypeScript 5.8+
• 有効な Logz.io アカウントと API キー

セットアップ

# Clone the repository
git clone https://github.com/jklnr/logzio-mcp-server.git
cd mcp-server-logzio

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Run in development mode
npm run dev

スクリプト

• npm run build - TypeScript をコンパイル
• npm run dev - 開発モードで実行
• npm test - テストスイートを実行
• npm run format - Prettier でコードをフォーマット
• npm run type-check - 出力せずに型チェックを実行

📁 プロジェクト構成

mcp-server-logzio/
├── src/
│   ├── api/           # Logz.io API client and types
│   ├── tools/         # MCP tool implementations
│   ├── utils/         # Utilities (logging, errors)
│   ├── config.ts      # Configuration management
│   ├── server.ts      # MCP server implementation
│   └── index.ts       # Entry point
├── tests/             # Test suites
├── examples/          # Usage examples
├── docs/              # Documentation
└── dist/              # Compiled output