home / mcp / gitlab forum mcp server

GitLab Forum MCP Server

Discourse MCP server configured specifically for GitLab forum troubleshooting and support

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ahnmichael-gitlab-forum-mcp": {
      "url": "https://forum.gitlab.com"
    }
  }
}

You can run a specialized MCP server tuned for searching and reading GitLab forum discussions. This server lets you quickly search, read, and analyze GitLab forum topics to troubleshoot CI/CD issues, explore features, and get community insights from the GitLab forum domain.

How to use

Use an MCP client to connect to the GitLab Forum MCP and access tools like search, read topic threads, read individual posts, browse categories and tags, and filter topics. Start with the HTTP server configuration to reach the remote GitLab forum MCP endpoint, or run the local stdio version to execute the MCP client locally.

How to install

Prerequisites: Node.js version 18 or newer, and an active internet connection to access the GitLab forum.

# Option 1: Run the remote HTTP MCP server (endpoint provided by the author)
# No local installation required for the MCP client depending on your setup

Additional content

Configuration includes both a remote HTTP MCP server configuration and a local stdio runtime using a command-line invocation. The HTTP method connects to the actual forum endpoint, while the stdio method runs the MCP client locally via a package runner.

{
  "mcpServers": {
    "gitlab_forum": {
      "type": "http",
      "name": "gitlab_forum",
      "url": "https://forum.gitlab.com",
      "args": []
    }
  }
}

{
  "mcpServers": {
    "gitlab_forum_stdio": {
      "type": "stdio",
      "name": "gitlab_forum_stdio",
      "command": "npx",
      "args": ["-y", "@ahnmichael/gitlab-forum-mcp@latest", "--site", "https://forum.gitlab.com"]
    }
  }
}

Available tools

discourse_search

Search GitLab forum discussions to find threads matching your query.

discourse_read_topic

Read full topic threads to view all posts within a discussion.

discourse_read_post

Read individual posts to inspect specific messages within a thread.

discourse_list_categories

Browse forum categories to filter topics by area (e.g., CI/CD, features, troubleshooting).

discourse_list_tags

Browse available tags to refine topic searches and filtering.

discourse_get_user

Get user information for a forum member, including profile details.

discourse_filter_topics

Filter topics by criteria such as category, tag, or author to narrow results.