README.md•1.61 kB
# GitLab MCP Server (in Python)
Model Context Protocol (MCP) server for GitLab integration, built on FastMCP.
This server is implemented in Python, with fastmcp.
## Quick Start
1. Build the Docker image:
```bash
docker build -t gitlab-mcp-server .
```
## Integration with Cursor/Claude
In MCP Settings -> Add MCP server, add this config:
```json
{
"mcpServers": {
"gitlab": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"GITLAB_TOKEN",
"-e",
"GITLAB_URL",
"gitlab-mcp-server:latest"
],
"env": {
"GITLAB_TOKEN": "token",
"GITLAB_URL": "https://gitlab.com/"
}
}
}
}
```
Note: Don't forget to replace `GITLAB_TOKEN` and `GITLAB_URL` values with your actual GitLab credentials and instance URL.
## Getting GitLab Token
1. Log in to your GitLab account
2. Go to Settings -> Access Tokens
3. Create a new token:
- Scopes: select the necessary permissions:
- `api` - for API access
- `read_repository` - for reading repositories
- `write_repository` - for writing to repositories
4. Click "Create personal access token"
5. Copy the generated token (it will be shown only once!)
## Functions
- ✅1.create_repository
- ✅2.fork_repository
- ✅3.delete_repository
- ✅4.search_repositories
- ✅5.create_or_update_file
- ✅6.push_files
- ✅7.get_file_contents
- ✅8.create_issue
- ✅9.get_issues
- ✅10.create_merge_request
- ✅11.get_merge_request_diff
- ✅12.create_branches
- ✅13.delete_branches
- ✅14.create_tags
- ✅15.delete_tags