MCP Server Gitlab

🚀 mcp-gitlab MCP Server

An integrated GitLab server built on the fastmcp framework, offering a variety of GitLab RESTful API tools. It supports integration with platforms such as Claude and Smithery.

✨ Features

• GitlabSearchUserProjectsTool: Search for users and their active projects by username.
• GitlabGetUserTasksTool: Retrieve the current user's pending tasks.
• GitlabSearchProjectDetailsTool: Search for projects and their detailed information.
• GitlabCreateMRCommentTool: Add comments to merge requests.
• GitlabAcceptMRTool: Accept and merge merge requests.
• GitlabUpdateMRTool: Update the assignee, reviewer, title, description, and labels of a merge request.
• GitlabCreateMRTool: Create a new merge request, supporting the specification of assignees and reviewers.
• GitlabRawApiTool: Call any GitLab API with custom parameters.

🚀 Quick Start

# Install dependencies
bun install

# Build the project
bun run build

# Start the server
bun run start

📦 Environment Variables

GITLAB_API_URL=https://your-gitlab-instance.com
GITLAB_TOKEN=your_access_token

# Optional: Provide a mapping from usernames to user IDs (JSON string)
# This can reduce API calls, especially when frequently referencing the same users.
# Example: {"username1": 123, "username2": 456}
GITLAB_USER_MAPPING={"username1": 123, "username2": 456}

# Optional: Provide a mapping from project names to project IDs (JSON string)
# Project IDs can be numbers or strings (e.g., "group/project").
# This can reduce API calls and ensure correct project usage.
# Example: {"project-name-a": 1001, "group/project-b": "group/project-b"}
GITLAB_PROJECT_MAPPING={"project-name-a": 1001, "group/project-b": "group/project-b"}

💻 Usage Examples

For detailed examples, please refer to USAGE.md.

📚 Project Structure

src/
├── server/
│   └── GitlabMCPServer.ts          # Entry file for the MCP server
├── tools/
│   ├── GitlabAcceptMRTool.ts
│   ├── GitlabCreateMRCommentTool.ts
│   ├── GitlabGetUserTasksTool.ts
│   ├── GitlabRawApiTool.ts
│   ├── GitlabCreateMRTool.ts
│   └── GitlabUpdateMRTool.ts
└── README.md                      # Project documentation

🔗 Related Links

• fastmcp
• Smithery
• GitLab API