MCP Server for Logz.io

Logz.io MCP 服务

开源的 Model Context Protocol（MCP）服务，可让 Claude 等 AI 助手与 Logz.io 的日志管理平台交互。提供简单日志搜索、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
• 等等。

🔧 可用工具

以下是你的 Agent 可以使用的工具。

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