Gigapipe MCP

🚀 Gigapipe MCP Server

A Machine Control Protocol (MCP) server for Gigapipe, offering a unified interface to query Prometheus metrics, Loki logs, and Tempo traces.

🚀 Quick Start

The Gigapipe MCP Server provides a unified way to interact with Prometheus, Loki, and Tempo. It allows you to query metrics, logs, and traces through a single interface.

✨ Features

Prometheus Integration

• Query metrics using PromQL.
• List all available labels.
• Get values for specific labels.
• Support for time range queries.

Loki Integration

• Query logs using LogQL.
• List all available labels.
• Get values for specific labels.
• Support for time range queries.

Tempo Integration

• Query traces by trace ID.
• List all available trace tags.
• Get values for a specific trace tag.
• Support for JSON trace format.

📦 Installation

# Clone the repository
git clone https://github.com/lmangani/gigapipe-mcp.git
cd gigapipe-mcp

# Build the server
go build -o gigapipe-mcp

📚 Documentation

Configuration

The server can be configured using environment variables:

# Required: Gigapipe server address (default: http://localhost:3100)
# Must include protocol (http:// or https://)
export GIGAPIPE_HOST="https://your-host:3100"

# Optional: HTTP Basic Authentication
export GIGAPIPE_USERNAME="your-username"
export GIGAPIPE_PASSWORD="your-password"

⚠️ Important Note

If no protocol is specified in GIGAPIPE_HOST, http:// will be used as the default.

Usage

Prometheus Tools

Basic Usage

# Query metrics with PromQL
prometheus_query --query="rate(http_requests_total[5m])" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --step="1m"

Advanced Usage

# List all available labels
prometheus_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"

# Get values for a specific label
prometheus_label_values --label="instance" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"

Loki Tools

Basic Usage

# Query logs with LogQL
loki_query --query='{job="varlogs"}' --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z" --limit="100"

Advanced Usage

# List all available labels
loki_labels --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"

# Get values for a specific label
loki_label_values --label="job" --start="2024-01-01T00:00:00Z" --end="2024-01-01T01:00:00Z"

Tempo Tools

Basic Usage

# Query a trace by ID
tempo_query --trace_id="1234567890abcdef"

Advanced Usage

# List all available trace tags
tempo_tags

# Get values for a specific trace tag
tempo_tag_values --tag="service.name"

API Endpoints

The server communicates with Gigapipe using the following endpoints:

Development

Prerequisites

• Go 1.16 or later
• Git

Building from Source

# Clone the repository
git clone https://github.com/lmangani/gigapipe-mcp.git
cd gigapipe-mcp

# Install dependencies
go mod download

# Build the server
go build -o gigapipe-mcp

# Run tests
go test ./...

📄 License

MIT License