DevOps MCP Server

A Model Context Protocol (MCP) server for DevOps operations, providing tools for Docker image management and GitLab CI/CD configuration.

Features

Docker Tools

• Search Docker Images: Find Docker images by keyword

• Get Image Tags: Retrieve all available tags for a specific Docker image

GitLab CI Tools

• Search GitLab CI References: Find GitLab CI reference YAML files

• Get Reference Versions: List all versions for a specific CI reference

• Get Pipeline Info: Retrieve detailed GitLab CI custom pipeline information

Installation

Prerequisites

PEM Certificate

This server requires a PEM certificate for authenticating with the DevOps API at https://labs.pointware.com.

1. Place your PEM certificate file in the certs/ directory as client-cert.pem

2. The certificate will be included when packaging the server

Configuration

For Claude Desktop

Add this configuration to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Or if installed globally via npm:

Available Tools

1. search_docker_images

Search for Docker images by keyword.

Parameters:

• keyword (string, required): Search term (e.g., "nginx", "postgres")

Example:

2. get_docker_image_tags

Get all available tags for a specific Docker image.

Parameters:

• imageName (string, required): Docker image name

Example:

3. search_gitlab_references

Search for GitLab CI reference YAML files.

Parameters:

• keyword (string, required): Search term (e.g., "node", "python")

Example:

4. get_gitlab_reference_versions

Get all versions for a specific GitLab CI reference.

Parameters:

• referenceName (string, required): Reference name

Example:

5. get_gitlab_pipeline_info

Get detailed information about a GitLab CI custom pipeline.

Parameters:

• pipelineName (string, required): Pipeline name

Example:

Development

Setup

Project Structure

API Endpoints

The server communicates with the following API endpoints:

• GET /api/v1/docker/images?keyword={keyword} - Search Docker images

• GET /api/v1/docker/images/{imageName}/tags - Get Docker image tags

• GET /api/v1/gitlab/references?keyword={keyword} - Search GitLab CI references

• GET /api/v1/gitlab/references/{referenceName}/versions - Get reference versions

• GET /api/v1/gitlab/pipelines/{pipelineName} - Get pipeline information

Security

• All API requests are authenticated using PEM certificates

• The certificate file is included in the package distribution

• HTTPS is enforced for all API communications

Requirements

• Node.js >= 18.0.0

• PEM certificate file for API authentication

License

MIT

Support

For issues and questions, please open an issue on the GitHub repository.