centreon-mcp-go

An MCP (Model Context Protocol) server for Centreon monitoring, written in Go.

Exposes 75 tools covering real-time monitoring, host and service configuration, downtime and acknowledgement management, infrastructure, users, and notifications. Integrates with any MCP-compatible AI client such as Claude Code or Claude Desktop.

• 73 tools across 11 categories — monitoring, operations, downtimes, acknowledgements, host config, service config, infrastructure, users, notifications, platform status, and connection testing
• Three transport modes — stdio (default), HTTP (streamable), and HTTP gateway mode
• Structured JSON logging via log/slog with configurable levels
• Gateway mode with token cache — per-request Centreon credentials via HTTP headers, with a 50-minute token cache to avoid repeated logins
• Self-signed certificate support — opt-in via CENTREON_ALLOW_SELF_SIGNED

• Go 1.26 or later
• A Centreon instance with REST API v2 access
• API credentials (username/password or API token)

go install github.com/tphakala/centreon-mcp-go@latest

git clone https://github.com/tphakala/centreon-mcp-go
cd centreon-mcp-go
go build -o centreon-mcp-go .

# Build the image (or: task image:build)
podman build -t centreon-mcp .

# Run in HTTP mode
podman run -d \
  -e CENTREON_HOST=https://centreon.example.com \
  -e CENTREON_USERNAME=apiuser \
  -e CENTREON_PASSWORD=secret \
  -e MCP_TRANSPORT=http \
  -p 8080:8080 \
  centreon-mcp

All configuration is via environment variables.

| Variable | Required | Default | Description | |-----------------------------|----------|-------------|--------------------------------------------------------------| | CENTREON_HOST | Yes | —