Loki MCP Server

- Go 1.16 or higher

Build and run the server:

The Loki query tool supports the following environment variables:
- LOKI_URL: Default Loki server URL to use if not specified in the request

- LOKI_ORG_ID: Default organization ID to use if not specified in the request

- LOKI_USERNAME: Default username for basic authentication if not specified in the request

- LOKI_PASSWORD: Default password for basic authentication if not specified in the request

- LOKI_TOKEN: Default bearer token for authentication if not specified in the request
Security Note: When using authentication environment variables, be careful not to expose sensitive credentials in logs or configuration files. Consider using token-based authentication over username/password when possible.
export LOKI_URL="http://localhost:3100"

./loki-mcp-client loki_query "{job=\"varlogs\"}"
export LOKI_URL="http://localhost:3100"

export LOKI_ORG_ID="tenant-123"

./loki-mcp-client loki_query "{job=\"varlogs\"}"
export LOKI_URL="http://localhost:3100"

export LOKI_USERNAME="admin"

export LOKI_PASSWORD="password"

./loki-mcp-client loki_query "{job=\"varlogs\"}"
export LOKI_URL="http://localhost:3100"

export LOKI_TOKEN="your-bearer-token"

./loki-mcp-client loki_query "{job=\"varlogs\"}"
export LOKI_URL="http://localhost:3100"

export LOKI_ORG_ID="tenant-123"

export LOKI_USERNAME="admin"

export LOKI_PASSWORD="password"

./loki-mcp-client loki_query "{job=\"varlogs\"}"
./loki-mcp-client loki_query "{job=\"varlogs\"}" "" "" "" "" "" "tenant-123"

./insert-loki-logs.sh --env "production" --interval 0.5

The Claude Desktop configuration file is located at:
- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%\Claude\claude_desktop_config.json
- On Linux: ~/.config/Claude/claude_desktop_config.json

You can use one of the example configurations provided in this repository:
- claude_desktop_config.json: Generic template
- claude_desktop_config_example.json: Example using go run with the current path
- claude_desktop_config_binary.json: Example using the compiled binary
- claude_desktop_config_script.json: Example using a shell script (recommended for go run)
- claude_desktop_config_docker.json: Example using Docker (most reliable)

Notes:
- When using go run with Claude Desktop, you may need to set several environment variables in both the script and the configuration file:
- HOME: The user's home directory
- GOPATH: The Go workspace directory
- GOMODCACHE: The Go module cache directory
- GOCACHE: The Go build cache directory

These are required to ensure Go can find its modules and build cache when run from Claude Desktop.

- Using Docker is the most reliable approach as it packages all dependencies and environment variables in a container.

Or create your own configuration:

{
  "mcpServers": {
    "lokiserver": {
      "command": "path/to/loki-mcp-server",
      "args": [],
      "env": {
        "LOKI_URL": "http://localhost:3100",
        "LOKI_ORG_ID": "your-default-org-id",
        "LOKI_USERNAME": "your-username",
        "LOKI_PASSWORD": "your-password",
        "LOKI_TOKEN": "your-bearer-token"
      },
      "disabled": false,
      "autoApprove": ["loki_query"]
    }
  }
}

Make sure to replace path/to/loki-mcp-server with the absolute path to the built binary or source code.

4. Restart Claude Desktop.

5. You can now use the tools in Claude:
- Loki query examples:
- "Query Loki for logs with the query {job=\"varlogs\"}"
- "Find error logs from the last hour in Loki using query {job=\"varlogs\"} |= \"ERROR\""
- "Show me the most recent 50 logs from Loki with job=varlogs"
- "Query Loki for logs with org 'tenant-123' using query {job=\"varlogs\"}"

The project includes comprehensive unit tests and CI/CD workflows to ensure reliability:

```bash