Skip to main content
Glama
GitLab Forum MCP

GitLab Forum MCP

by ahnmichael

GitLab Forum MCP

⚠️ This is an unofficial, community-created MCP - not affiliated with or endorsed by GitLab Inc.

A Model Context Protocol (MCP) stdio server specifically configured for GitLab forum troubleshooting and support. This is a specialized fork of discourse-mcp optimized for https://forum.gitlab.com.

Perfect for GitLab users and support teams who need to quickly search, read, and analyze discussions on GitLab's community forum for troubleshooting CI/CD issues, GitLab features, and community support.

GitLab-Specific Features

  • 🎯 Pre-configured for GitLab forum (https://forum.gitlab.com)

  • 🔍 Enhanced search with GitLab compatibility fixes - improved error handling and debug logging

  • ⚡ Optimized workflows for GitLab troubleshooting scenarios

  • 📁 Ready-to-use profile - just clone and run

  • 🏷️ GitLab-focused configuration for common support topics

Related MCP server: GitLab MCP Server

Quick Start

Command Line Usage

Recommended: Run with GitLab forum profile

npx -y @ahnmichael/gitlab-forum-mcp@latest --profile gitlab-forum-profile.json

Alternative: Run with site parameter

npx -y @ahnmichael/gitlab-forum-mcp@latest --site https://forum.gitlab.com

Use in Claude Desktop

Add to your claude_desktop_config.json:

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

Or with the profile configuration:

{
  "mcpServers": {
    "gitlab-forum": {
      "command": "npx",
      "args": ["-y", "@ahnmichael/gitlab-forum-mcp@latest", "--profile", "/path/to/gitlab-forum-profile.json"]
    }
  }
}

Available Tools

  • discourse_search - Search GitLab forum discussions

  • discourse_read_topic - Read full topic threads

  • discourse_read_post - Read individual posts

  • discourse_list_categories - Browse forum categories

  • discourse_list_tags - Browse available tags

  • discourse_get_user - Get user information

  • discourse_filter_topics - Filter topics by various criteria

Getting the Profile File

  1. Clone this repository:

    git clone https://github.com/ahnmichael/gitlab-forum-mcp.git
    cd gitlab-forum-mcp
  2. Use the profile file:

    npx -y @ahnmichael/gitlab-forum-mcp@latest --profile gitlab-forum-profile.json

Requirements

  • Node.js: >= 18

  • Internet connection to access GitLab forum

Contributing

This is a specialized fork of discourse-mcp for GitLab forum usage.

  • Report issues: GitHub Issues

  • Source code: Built with Node.js and TypeScript

  • Contributing: PRs welcome for GitLab-specific improvements

License

MIT License - see LICENSE file for details.

Acknowledgments

  • Original discourse-mcp project by Discourse

  • Enhanced search functionality developed through Claude Desktop testing

Available Tools

8 tools
discourse_filter_topicsFilter TopicsA

Filter topics with a concise query language: use key:value tokens separated by spaces; category/categories for categories (comma = OR, '=category' = without subcats, '-' prefix = exclude), tag/tags (comma = OR, '+' = AND) and tag_group; status:(open|closed|archived|listed|unlisted|public) and personal in:(bookmarked|watching|tracking|muted|pinned); dates: created/activity/latest-post-(before|after) with YYYY-MM-DD or N (days); numeric: likes[-op]-(min|max), posts-(min|max), posters-(min|max), views-(min|max); order: activity|created|latest-post|likes|likes-op|posters|title|views|category with optional -asc; free text terms are matched full-text. Results are permission-aware.

Inputs: filter (required), page, per_page.

discourse_get_userGet UserC

Get basic user info.

Inputs: username (required).

discourse_list_categoriesList CategoriesB

List categories visible to the current auth context.

Inputs: no named parameters.

discourse_list_tagsList TagsC

List tags (if enabled).

Inputs: no named parameters.

discourse_read_postRead PostC

Read a specific post.

Inputs: post_id (required).

discourse_read_topicRead TopicC

Read a topic metadata and first N posts.

Inputs: topic_id (required), post_limit, start_post_number.

discourse_select_siteSelect SiteA

Validate and select a Discourse site for subsequent tool calls.

Inputs: site (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: filtering topics, getting user info, listing categories/tags, reading posts/topics, searching content, and selecting a site. The descriptions reinforce these distinct roles, making misselection unlikely.

    Naming Consistency5/5

    All tools follow a consistent 'discourse_verb_noun' pattern (e.g., discourse_filter_topics, discourse_get_user, discourse_list_categories). This predictable naming scheme enhances readability and usability across the set.

    Tool Count5/5

    With 8 tools, this server is well-scoped for interacting with a GitLab forum (Discourse instance). Each tool serves a specific, non-redundant function, covering core operations like reading, listing, filtering, and searching without being overly sparse or bloated.

    Completeness4/5

    The toolset provides strong coverage for reading and querying forum data, including topics, posts, users, categories, and tags. A minor gap exists in write operations (e.g., creating or replying to posts), but agents can still perform most common read-only workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables AI-powered exploration and interaction with GitLab instances through comprehensive search, code browsing, and repository management. Supports both self-hosted and GitLab.com with flexible authentication for read and write operations.
      69
      186 npm
      13
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Connects AI assistants to GitLab to interact with merge requests, reviews, discussions, pipelines, and test results through natural language queries. Supports viewing MR details, responding to comments, checking test summaries, and analyzing job logs.
      12
      2
      -
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects AI assistants to GitLab projects, enabling natural language queries for merge requests, code reviews, test results, pipelines, and discussions. Supports viewing MR details, responding to comments, and analyzing CI/CD job logs.
      -