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 "Install 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 MCPsearch 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
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
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.