GitLab Documentation

Provides full-text search and retrieval of GitLab documentation across multiple repositories for MCP clients.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nunolima-gitlab-docs-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "nunolima/gitlab-docs-mcp:18.7"
      ]
    }
  }
}

This MCP server provides searchable access to GitLab documentation by indexing markdown files from multiple GitLab OSS repositories and exposing them through a simple MCP interface. You can use it with your AI assistant or any MCP client to search, retrieve, and explore GitLab documentation across versions and components.

How to use

You connect an MCP client to this server to perform searches, fetch specific documentation, and list indexed repositories. Use the available tools to search for topics like CI/CD, pipelines, runners, or GitLab Pages, or to retrieve exact documentation pages by their file paths. The server is designed to be practical for day-to-day querying of GitLab documentation across multiple repositories and versions.

How to install

Prerequisites you need before running the MCP server:

Docker installed and running
An MCP-compatible client (for example Claude Desktop, Cline, or Cursor) to connect to the server

Install and run the MCP server using Docker images that specify GitLab versioned builds or the latest main branch as shown below.

Choose a version to run, then start the container image corresponding to that version. The commands below demonstrate building and running with specific tags or the latest tag.

To run a specific GitLab version image from the published Docker tag, use the following runtime configuration.

# Run a GitLab documentation MCP server for a specific GitLab version
# Use the exact image tag shown in your setup
docker run -i --rm nunolima/gitlab-docs-mcp:18.7

Additional setup notes

If you want to verify basic server readiness, initialize the MCP client session and list available tools after the server starts. The server exposes these core capabilities: search_docs for full-text search across all GitLab documentation, get_doc to retrieve a specific document by path, and list_repositories to enumerate the indexed repositories.

Available tools

search_docs

Performs a full-text search across all indexed GitLab documentation to find relevant topics, options, and configuration guidance.

get_doc

Retrieves a specific documentation page or section by its file path from the indexed Markdown sources.

list_repositories

Lists all repositories that have documentation indexed by the server, including GitLab CE/EE, Runner, Omnibus, Gitaly, Pages, and Agent.