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

npm install devops-mcp-server

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

{
  "mcpServers": {
    "devops": {
      "command": "node",
      "args": [
        "/path/to/devops-mcp-server/dist/index.js"
      ]
    }
  }
}

Or if installed globally via npm:

{
  "mcpServers": {
    "devops": {
      "command": "devops-mcp-server"
    }
  }
}

Available Tools

1. search_docker_images

Search for Docker images by keyword.

Parameters:

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

Example:

Search for nginx Docker images

2. get_docker_image_tags

Get all available tags for a specific Docker image.

Parameters:

• imageName (string, required): Docker image name

Example:

Get tags for nginx image

3. search_gitlab_references

Search for GitLab CI reference YAML files.

Parameters:

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

Example:

Search for GitLab CI references related to node

4. get_gitlab_reference_versions

Get all versions for a specific GitLab CI reference.

Parameters:

• referenceName (string, required): Reference name

Example:

Get versions for node-ci-template reference

5. get_gitlab_pipeline_info

Get detailed information about a GitLab CI custom pipeline.

Parameters:

• pipelineName (string, required): Pipeline name

Example:

Get information about custom-deploy-pipeline

Development

Setup

# Install dependencies
npm install

# Build the project
npm run build

# Watch mode for development
npm run watch

Project Structure

devops-mcp-server/
├── src/
│   ├── api/           # API client with PEM authentication
│   ├── tools/         # MCP tool implementations
│   ├── types/         # TypeScript type definitions
│   └── index.ts       # Main server entry point
├── certs/             # PEM certificates directory
├── dist/              # Compiled JavaScript output
└── package.json

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.