GitLab Forum MCP
This GitLab Forum MCP server provides specialized tools for searching, reading, and analyzing discussions on GitLab's community forum (forum.gitlab.com).
• Search forum content - Search discussions with customizable result limits and private content options • Read topics and posts - Access full topic threads by ID with configurable post count and starting position, or read individual posts by their unique ID • Browse forum structure - List available categories and tags within the forum • Filter topics - Use advanced filtering with flexible query language supporting categories, tags, status, dates, numeric ranges (likes, posts, views), pagination, and ordering • Access user information - Retrieve basic user details by username • Site configuration - Validate and select Discourse sites (pre-configured for GitLab forum) • GitLab-specific optimization - Enhanced search functionality and error handling tuned for GitLab forum troubleshooting scenarios
Provides tools for interacting with Discourse forums, including searching posts, reading topics and posts, listing categories and tags, filtering topics, and creating new content (posts, topics, categories, users) when write permissions are enabled.
Specialized integration for GitLab's community forum (forum.gitlab.com) optimized for GitLab troubleshooting scenarios, CI/CD issue resolution, and community support with GitLab-focused search filters and workflows.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GitLab Forum MCP search for CI/CD pipeline timeout issues"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.jsonAlternative: Run with site parameter
npx -y @ahnmichael/gitlab-forum-mcp@latest --site https://forum.gitlab.comUse 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
Clone this repository:
git clone https://github.com/ahnmichael/gitlab-forum-mcp.git cd gitlab-forum-mcpUse 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 toolsdiscourse_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_searchDiscourse SearchC
Search site content.
Inputs: query (required), with_private, max_results.
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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Search or monitor any Flarum-powered forum for discussions, replies, participants, dates, and…
Provides tools for searching Google Workspace documentation and much more.
Search, monitor and measure Reddit posts and comments. Previews work with no API key.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables 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.69186 npm13MIT
- FlicenseAqualityCmaintenanceConnects 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.122-
- FlicenseNot gradedqualityNot gradedmaintenanceConnects AI assistants to GitLab, enabling natural language queries for merge requests, code reviews, pipeline tests, job logs, and commit discussions directly from chat.-
- FlicenseNot gradedqualityNot gradedmaintenanceConnects 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.-