DevOps MCP Server

# 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 ```bash 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` ```json { "mcpServers": { "devops": { "command": "node", "args": [ "/path/to/devops-mcp-server/dist/index.js" ] } } } ``` Or if installed globally via npm: ```json { "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 ```bash # 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.