Fotos en chino
Servidor MCP mcp-gitlab (en inglés)
Un servidor de integración de GitLab basado en el framework fastmcp, que proporciona diversas herramientas API RESTful de GitLab. Compatible con Claude, Smithery y otras plataformas.
Características
- GitlabSearchUserProjectsTool : busca usuarios y sus proyectos activos por nombre de usuario
- GitlabGetUserTasksTool : Obtener las tareas pendientes del usuario actual
- GitlabSearchProjectDetailsTool : Buscar proyectos y detalles
- GitlabCreateMRCommentTool : Agregar comentarios a las solicitudes de fusión
- GitlabAcceptMRTool : aceptar y fusionar solicitudes de fusión
- GitlabUpdateMRTool : Actualizar el asignado, los revisores, el título, la descripción y las etiquetas de la solicitud de fusión
- GitlabCreateMRTool : Crea una nueva solicitud de fusión con asignados y revisores
- GitlabRawApiTool : llama a cualquier API de GitLab con parámetros personalizados
Inicio rápido
# Install dependencies
bun install
# Build the project
bun run build
# Start the server
bun run start
Variables de entorno
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 referencing the same users frequently
# 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 the correct project is used
# Example: '{"project-name-a": 1001, "group/project-b": "group/project-b"}'
GITLAB_PROJECT_MAPPING={"project-name-a": 1001, "group/project-b": "group/project-b"}
Ejemplos de uso
Consulte USAGE.md para obtener ejemplos detallados de los parámetros de cada herramienta.
Estructura del proyecto
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 config
USAGE.md # Usage examples
package.json
tsconfig.json
Integración
Cliente de escritorio Claude
Añade a tu configuración:
{
"mcpServers": {
"@zephyr-mcp/gitlab": {
"command": "npx",
"args": ["-y", "@zephyr-mcp/gitlab"]
}
}
}
Herrería
Úselo directamente en la plataforma Smithery:
smithery add @zephyr-mcp/gitlab
O busque "@zephyr-mcp/gitlab" en Smithery UI y agréguelo a su espacio de trabajo.
Variables de entorno:
GITLAB_API_URL : URL base de su API de GitLabGITLAB_TOKEN : Token de acceso para la autenticación de la API de GitLab
Enlaces relacionados