Zephyrdeng MCP Server Gitlab

🚀 mcp-gitlab MCP Server

A GitLab integration server built on the Model Context Protocol (MCP) framework, offering a variety of GitLab RESTful API tools and supporting integration with platforms like 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, reviewers, title, description, and labels of a Merge Request.
• GitlabCreateMRTool: Create a new Merge Request, supporting the assignment of assignees and reviewers.
• GitlabRawApiTool: Customize and call any GitLab API.

🚀 Quick Start

# Install dependencies
bun install

# Build the project
bun run build

# Start the service
bun run start

📦 Installation

Environment Variable Configuration

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

💻 Usage Examples

For detailed examples, see USAGE.md, which includes parameter examples for each tool.

Basic Usage

# Install dependencies
bun install

# Build the project
bun run build

# Start the service
bun run start

📚 Documentation

Project Structure

src/
├── server/
│   └── GitlabMCPServer.ts          # MCP server entry point
├── tools/
│   ├── GitlabAcceptMRTool.ts
│   ├── GitlabCreateMRCommentTool.ts
│   ├── GitlabGetUserTasksTool.ts
│   ├── GitlabRawApiTool.ts
│   ├── GitlabSearchProjectDetailsTool.ts
│   ├── GitlabSearchUserProjectsTool.ts
│   └── gitlab/
│       ├── FieldFilterUtils.ts
│       ├── GitlabApiClient.ts
│       └── GitlabApiTypes.ts
├── utils/
│   ├── is.ts
│   └── sensitive.ts
smithery.json                      # Smithery configuration
USAGE.md                          # Usage examples
package.json
tsconfig.json

Integration Methods

Claude Desktop Client

Add the following to the configuration file:

{
  "mcpServers": {
    "@zephyr-mcp/gitlab": {
      "command": "npx",
      "args": ["-y", "@zephyr-mcp/gitlab@0.1.0"]
    }
  }
}

Configuration parameters:

• GITLAB_API_URL: The base URL of the GitLab API.
• GITLAB_TOKEN: The access token used to authenticate GitLab API requests.

📄 Related Links

• fastmcp
• Smithery
• GitLab API