Máy chủ Loki MCP Đơn Giản

Máy chủ “Loki Đơn Giản” MCP dùng để làm gì?

Máy chủ Loki MCP Đơn Giản là giao diện Model Context Protocol (MCP) cho phép các trợ lý AI truy vấn và phân tích trực tiếp log từ một phiên bản Grafana Loki. Bằng cách sử dụng các công cụ như logcli hoặc dự phòng qua Loki HTTP API, máy chủ này cho phép tích hợp liền mạch dữ liệu log vào quy trình phát triển. Nó hỗ trợ truy vấn LogQL đầy đủ, truy xuất giá trị nhãn, và cung cấp kết quả được định dạng với nhiều tùy chọn đầu ra (mặc định, raw, JSON lines). Với xác thực và cấu hình linh hoạt qua biến môi trường hoặc file cấu hình, máy chủ Loki MCP Đơn Giản lý tưởng để nâng cao khả năng quan sát, xử lý sự cố và giám sát trong các ứng dụng AI hoặc luồng tự động hóa.

Danh sách Prompt

Không có mẫu prompt cụ thể nào được đề cập trong repository hoặc tài liệu.

Danh sách Resource

Không có resource MCP cụ thể nào được liệt kê trong repository hoặc tài liệu.

Danh sách Công cụ

• query-loki
  Truy vấn log từ Loki với các tùy chọn lọc. Công cụ này cho phép người dùng gửi truy vấn LogQL và truy xuất các log, hỗ trợ nhiều định dạng đầu ra và truy cập metadata nhãn.

Các trường hợp sử dụng của MCP Server này

• Phân tích Log và xử lý sự cố
  Các lập trình viên có thể dùng máy chủ Loki MCP Đơn Giản để phân tích và lọc log từ Grafana Loki, giúp dễ dàng debug ứng dụng và điều tra sự cố.
• Phản hồi sự cố tự động
  Trợ lý AI có thể tự động lấy và tóm tắt các log liên quan trong quy trình xử lý sự cố, cải thiện thời gian và độ chính xác phản hồi.
• Bảng điều khiển quan sát
  Tích hợp chức năng truy vấn log vào bảng điều khiển tùy chỉnh, cho phép xem log thời gian thực ngay trong công cụ phát triển hoặc giám sát.
• Giám sát bảo mật
  Sử dụng tác nhân AI để giám sát log nhằm phát hiện mẫu bất thường hoặc hoạt động đáng ngờ, kích hoạt cảnh báo hoặc hành động tự động khi có bất thường.
• Tối ưu hóa hiệu suất
  Phân tích dữ liệu log lịch sử để phát hiện nút thắt cổ chai, lỗi hoặc xu hướng ảnh hưởng đến hiệu suất hệ thống, hỗ trợ tối ưu hóa chủ động.

Hướng dẫn thiết lập

Windsurf

1. Đảm bảo Node.js v16+ đã được cài đặt.
2. Chỉnh sửa tệp cấu hình Windsurf của bạn (ví dụ, settings.json).
3. Thêm Máy chủ Loki MCP Đơn Giản vào phần mcpServers:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. Lưu và khởi động lại Windsurf.
5. Kiểm tra máy chủ đã chạy bằng cách xác minh chức năng truy vấn log.

Claude

1. Cài đặt Node.js v16+.
2. Sử dụng Smithery để cài đặt máy chủ:

   npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude
   

3. Thêm hoặc cập nhật cấu hình Claude như sau:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. Lưu và khởi động lại Claude.
5. Xác nhận chức năng truy vấn log Loki đã khả dụng.

Cursor

1. Xác nhận Node.js v16+ đã được cài đặt.
2. Mở tệp cấu hình của Cursor.
3. Chèn đoạn sau vào phần mcpServers:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. Lưu thay đổi và khởi động lại Cursor.
5. Thử nghiệm chức năng truy vấn log.

Cline

1. Đảm bảo Node.js v16+ khả dụng.
2. Xác định vị trí và mở tệp cấu hình của Cline.
3. Thêm entry Simple Loki MCP:

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. Lưu và khởi động lại Cline.
5. Kiểm tra tích hợp truy vấn log thành công.

Bảo mật API Key

Lưu trữ thông tin xác thực nhạy cảm (như LOKI_ADDR hoặc token) trong biến môi trường để bảo mật. Ví dụ:

{
  "mcpServers": {
    "simple-loki": {
      "command": "npx",
      "args": ["-y", "simple-loki-mcp"],
      "env": {
        "LOKI_ADDR": "${LOKI_ADDR_ENV}",
        "LOKI_TOKEN": "${LOKI_TOKEN_ENV}"
      },
      "inputs": {
        "query": "${YOUR_LOGQL_QUERY}"
      }
    }
  }
}

Cách sử dụng MCP này trong flows

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào workflow FlowHunt của bạn, hãy bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối nó với tác nhân AI:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "simple-loki": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, tác nhân AI có thể sử dụng MCP này như một công cụ với đầy đủ chức năng và khả năng. Lưu ý đổi “simple-loki” thành tên thực tế máy chủ MCP của bạn và thay URL bằng địa chỉ MCP server của bạn.

Tổng quan

Dựa trên bảng trên, Máy chủ Loki MCP Đơn Giản tập trung vào chức năng chính và hiệu quả nhưng thiếu đa dạng về prompt và resource. Nó dễ thiết lập, tài liệu rõ ràng cho tích hợp và bảo mật API key. Tổng thể, nó thực tế để truy vấn log nhưng hạn chế ở các khả năng MCP nâng cao.

MCP Score

Đánh giá:
Tôi đánh giá máy chủ MCP này 6/10. Nó hoàn thành tốt mục đích, dễ tích hợp nhưng thiếu sự đa dạng về công cụ, mẫu prompt và định nghĩa resource rõ ràng - những thứ cần thiết cho ứng dụng MCP rộng hơn. Không đề cập đến Roots hay hỗ trợ Sampling.