Máy chủ Loki MCP

Máy chủ “Loki” MCP làm gì?

Máy chủ Loki MCP là một triển khai Model Context Protocol (MCP) bằng Go được thiết kế để tích hợp với Grafana Loki, một hệ thống tổng hợp log. Nó đóng vai trò cầu nối giữa các trợ lý AI và nguồn dữ liệu log bên ngoài, cho phép AI truy vấn và tương tác với các luồng log lưu trữ trong Loki. Bằng cách cung cấp khả năng truy vấn của Loki qua giao thức MCP, các nhà phát triển và client AI có thể nâng cấp quy trình làm việc — như tìm kiếm, lọc và phân tích log — trực tiếp thông qua giao diện tiêu chuẩn do LLM điều khiển. Điều này trao quyền thực hiện các tác vụ như điều tra log thời gian thực, khắc phục sự cố và tạo dashboard, cung cấp quyền truy cập liền mạch vào dữ liệu vận hành để tăng cường khả năng quan sát và tự động hóa.

Danh sách Prompt

Không có prompt template nào được ghi lại trong kho lưu trữ.

Danh sách Resource

Không có MCP resource nào được mô tả rõ ràng trong kho lưu trữ.

Danh sách Công cụ

• loki_query
  Cho phép truy vấn dữ liệu log trên Grafana Loki.
  • Tham số bắt buộc:
    • query: Chuỗi truy vấn LogQL
  • Tham số tùy chọn:
    • url: URL máy chủ Loki (mặc định lấy từ biến môi trường LOKI_URL hoặc http://localhost:3100)
    • start: Thời gian bắt đầu truy vấn (mặc định: 1 giờ trước)
    • end: Thời gian kết thúc truy vấn (mặc định: hiện tại)
    • limit: Số lượng kết quả tối đa trả về (mặc định: 100)

Trường hợp sử dụng MCP Server này

• Khám phá dữ liệu log
  Nhà phát triển hoặc AI agent có thể lập trình truy vấn và phân tích dữ liệu log lưu trữ trên Grafana Loki, hỗ trợ khắc phục sự cố và phản ứng với sự cố.
• Giám sát log tự động
  Kích hoạt các quy trình giám sát do LLM điều khiển, nơi AI có thể quét log để phát hiện bất thường, lỗi hoặc sự kiện cụ thể.
• Dashboard vận hành
  Hỗ trợ tạo dashboard động bằng cách lấy dữ liệu log phục vụ cho công cụ trực quan hóa hoặc báo cáo.
• Phân tích nguyên nhân gốc
  Giúp AI phân tích lượng lớn log để xác định nguyên nhân phát sinh vấn đề bằng các truy vấn LogQL linh hoạt.

Cách thiết lập

Windsurf

1. Cài đặt Go 1.16 trở lên.

2. Biên dịch server:
   go build -o loki-mcp-server ./cmd/server

3. Chỉnh sửa cấu hình Windsurf để thêm máy chủ MCP.

4. Thêm máy chủ Loki MCP với đoạn JSON sau (tùy chỉnh theo nhu cầu):

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. Lưu cấu hình và khởi động lại Windsurf.

6. Kiểm tra server đã chạy và có thể truy cập.

Bảo mật API Key (Ví dụ dùng biến môi trường):

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Claude

1. Cài đặt Go 1.16 trở lên.

2. Biên dịch server như trên.

3. Mở file cấu hình MCP của Claude.

4. Thêm máy chủ Loki MCP:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. Lưu/khởi động lại Claude.

6. Xác nhận cấu hình đã hoạt động.

Bảo mật API Key:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Cursor

1. Đảm bảo đã cài Go 1.16+.

2. Biên dịch máy chủ Loki MCP.

3. Chỉnh sửa cấu hình của Cursor.

4. Thêm mục máy chủ Loki MCP:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. Lưu và khởi động lại Cursor.

6. Kiểm tra tích hợp.

Dùng biến môi trường:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Cline

1. Cài đặt Go >=1.16.

2. Biên dịch với:
   go build -o loki-mcp-server ./cmd/server

3. Tìm file cấu hình MCP của Cline.

4. Thêm máy chủ Loki MCP:

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. Lưu và khởi động lại Cline.

6. Kiểm tra thiết lập.

Bảo mật API Key bằng biến môi trường:

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

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

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình 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 với AI agent:

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, điền thông tin máy chủ MCP của bạn theo định dạng JSON sau:

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

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

Tổng quan

Dựa trên bảng trên, Máy chủ Loki MCP cung cấp tổng quan rõ ràng và một công cụ truy vấn log chức năng, nhưng thiếu prompt, resource và tính năng MCP nâng cao như sampling hay roots. Tài liệu tối giản và phù hợp cho lập trình viên.

Nhận xét của chúng tôi

Máy chủ Loki MCP tập trung và hiệu quả cho việc tích hợp LLM với truy vấn log Grafana Loki, nhưng tối giản và thiếu chiều sâu về tính năng MCP, cũng như tài liệu. Nếu chấm điểm, nó đạt 4/10: đáp ứng mục đích chính, nhưng chưa đầy đủ tính năng, chưa hoàn thiện hay có tài liệu chi tiết.

Điểm MCP