Frequently Asked Questions about the Simple Loki MCP Server

Q: What is the Model Context Protocol (MCP)?

A: MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs), enabling them to interact with external data sources and tools.

Q: What is Grafana Loki?

A: Grafana Loki is a horizontally scalable, highly available, multi-tenant log aggregation system inspired by Prometheus. It is designed to be very cost effective and easy to operate.

Q: What is logcli?

A: logcli is a command-line tool for querying Grafana Loki logs. The Simple Loki MCP Server uses logcli to interact with the Loki server.

Q: What are the prerequisites for using the Simple Loki MCP Server?

A: You need Node.js v16 or higher, TypeScript, logcli installed and accessible in your PATH, and access to a Loki server instance.

Q: How do I install the Simple Loki MCP Server?

A: You can install it via Smithery using the command npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude, or manually by cloning the repository, installing dependencies, and building the project.

Q: How do I configure the Simple Loki MCP Server?

A: You can configure it using environment variables or a logcli-config.yaml file.

Q: What environment variables can I use to configure the Simple Loki MCP Server?

A: You can use LOKI_ADDR, LOKI_USERNAME, LOKI_PASSWORD, LOKI_TENANT_ID, LOKI_BEARER_TOKEN, LOKI_BEARER_TOKEN_FILE, LOKI_CA_FILE, LOKI_CERT_FILE, LOKI_KEY_FILE, LOKI_ORG_ID, LOKI_TLS_SKIP_VERIFY, LOKI_CONFIG_PATH, and DEBUG.

Q: Where can I place the logcli-config.yaml file?

A: You can place it in a custom path specified by LOKI_CONFIG_PATH, the current working directory, or your home directory (~/.logcli-config.yaml).

Q: How do I start the Simple Loki MCP Server?

A: Run npm start to start the server, or npm run dev for development.

Q: What MCP tools are available?

A: The available tools are query-loki, get-label-values, and get-labels.

Q: What is UBOS and how does the Simple Loki MCP Server integrate with it?

A: UBOS is a full-stack AI Agent development platform. The Simple Loki MCP Server integrates with UBOS to enable AI Agents to access and analyze log data from Grafana Loki, facilitating AI-driven troubleshooting, proactive monitoring, security auditing, and performance optimization.

Q: What is LogQL?

A: LogQL is Loki’s query language. The Simple Loki MCP Server offers complete support for LogQL.