Gitlab MCP Server

🚀 About GitLab

GitLab is a powerful platform that provides a comprehensive solution for software development. It offers various features such as version control, issue tracking, and continuous integration. This README will guide you through the installation process, using dynamic tool discovery, i18n/overriding descriptions, and more.

🚀 Quick Start

📦 Installation

To obtain GitLab, follow these steps:

1. Visit the GitLab download page.
2. Select the appropriate version for your operating system and download it.
3. Complete the installation process by following the installation wizard.
4. Open GitLab and start using it.

📦 Self-hosted GitLab Instance

If you have a self-hosted GitLab instance, follow these steps:

1. Visit the GitLab installation documentation.
2. Choose the appropriate installation method based on your operating system and environment.
3. Configure the basic settings of GitLab, including the URL and authentication method.
4. Start the GitLab service and access your GitLab instance.

💻 Usage Examples

✨ Dynamic Tool Discovery

The dynamic tool discovery feature allows you to customize the tool usage experience as needed. Here are the steps to implement it:

🔧 Basic Usage

• Using command-line arguments:

./gitlab-mcp-server stdio --dynamic-toolsets

• Using environment variables:

export GITLAB_DYNAMIC_TOOLSETS=1
./gitlab-mcp-server stdio

🔧 Advanced Usage

• Using Docker:

docker run -i --rm \
  -e GITLAB_TOKEN=... \
  -e GITLAB_DYNAMIC_TOOLSETS=1 \
  your-docker-registry/gitlab-mcp-server:latest # Important: Update the image path!

✨ i18n / Overriding Descriptions

To achieve internationalization or customize descriptions, follow these steps:

🔧 Basic Usage

1. Create a gitlab-mcp-server-config.json file in the same directory as the server binary.
2. Add custom translation content:

{
  "TOOL_GET_ISSUE_DESCRIPTION": "Get detailed information about GitLab issues.",
  "TOOL_CREATE_MERGE_REQUEST_USER_TITLE": "Create a new MR"
}

🔧 Advanced Usage

3. Use the --export-translations flag to generate or update the configuration file:

./gitlab-mcp-server --export-translations 
# This will create/update the gitlab-mcp-server-config.json file

📄 License

Contributors are welcome! Please refer to CONTRIBUTING.md for detailed information.

This project is released under the MIT License.