@slorenzot/mcp-azure
Servidor MCP (Model Context Protocol) para Azure DevOps. Permite interactuar con Work Items, sprints, áreas, comentarios y adjuntos desde cualquier cliente MCP compatible.
Instalación
npm install -g @slorenzot/mcp-azure
O usar directamente con npx:
npx @slorenzot/mcp-azure
Configuración
Variables de Entorno
El servidor se configura automáticamente usando las siguientes variables de entorno:
| Variable | Alternativa | Descripción | Requerido |
|---|
AZURE_DEVOPS_ORG | ADO_ORG | URL de la organización (ej: https://dev.azure.com/mi-org) | Sí |
AZURE_DEVOPS_PAT | ADO_PAT | Personal Access Token | Sí |
AZURE_DEVOPS_PROJECT | ADO_PROJECT | Nombre del proyecto | No |
Configuración en Claude Desktop
Agrega la siguiente configuración en tu archivo claude_desktop_config.json:
{
"mcpServers": {
"azure-devops": {
"command": "npx",
"args": ["-y", "@slorenzot/mcp-azure"],
"env": {
"AZURE_DEVOPS_ORG": "https://dev.azure.com/tu-organizacion",
"AZURE_DEVOPS_PAT": "tu-pat-aqui",
"AZURE_DEVOPS_PROJECT": "tu-proyecto"
}
}
}
}
Obtener un Personal Access Token (PAT)
- Ve a tu organización de Azure DevOps
- Haz clic en tu avatar (esquina superior derecha)
- Selecciona Personal Access Tokens
- Crea un nuevo token con los siguientes permisos:
- Work Items: Read & Write
- Project and Team: Read (opcional)
Herramientas Disponibles
Autenticación
| Herramienta | Descripción |
|---|
ado_configure | Configura la conexión con organización, proyecto y PAT |
Work Items
| Herramienta | Descripción |
|---|
ado_get_work_item | Obtiene un Work Item por su ID |
ado_create_work_item | Crea un nuevo Work Item (User Story, Bug, Task, etc.) |
ado_update_work_item | Actualiza un Work Item existente |
ado_get_work_item_type_fields | Obtiene los campos disponibles/requeridos de un tipo |
Consultas
| Herramienta | Descripción |
|---|
ado_query_sprint | Consulta Work Items de un sprint específico |
ado_query_area | Consulta Work Items de un área específica |
ado_query_wiql | Ejecuta una consulta WIQL personalizada |
Estructura del Proyecto
| Herramienta | Descripción |
|---|
ado_list_iterations | Lista las iteraciones/sprints del proyecto |
ado_list_areas | Lista las áreas del proyecto |
Comentarios y Discusiones
| Herramienta | Descripción |
|---|
ado_add_comment | Agrega un comentario a un Work Item (soporta Markdown) |
ado_get_comments | Obtiene los comentarios de un Work Item |
Adjuntos
| Herramienta | Descripción |
|---|
ado_upload_attachment | Sube un archivo y devuelve la URL del adjunto |
ado_add_attachment | Agrega un adjunto a un Work Item |
ado_get_attachments | Lista los adjuntos de un Work Item |
Ejemplos de Uso
Crear una User Story
{
"title": "Implementar login con OAuth",
"type": "User Story",
"description": "Como usuario quiero poder iniciar sesión con mi cuenta de Google",
"areaPath": "MiProyecto\\Backend",
"iterationPath": "MiProyecto\\Sprint 5",
"fields": {
"Custom.OKR": "Seguridad",
"Custom.Prioridad": "Alta"
}
}
Consulta WIQL Personalizada
{
"wiql": "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active' AND [System.AssignedTo] = @Me ORDER BY [System.CreatedDate] DESC",
"getDetails": true
}
Agregar Comentario con Markdown
{
"id": 12345,
"comment": "## Análisis completado\n\n- Revisado el código\n- Identificados 3 issues\n\n**Próximo paso:** Corregir validaciones"
}
Subir y Adjuntar Archivo
{
"workItemId": 12345,
"filePath": "/ruta/al/archivo.pdf",
"comment": "Documento de especificaciones"
}
Prompts Disponibles
El servidor incluye prompts predefinidos para facilitar tareas comunes:
| Prompt | Descripción |
|---|
connect | Guía para conectarse a Azure DevOps |
analyze_sprint | Analiza el estado de un sprint |
create_user_story | Crea una User Story estructurada |
daily_standup | Genera un reporte de standup diario |
plan_sprint | Ayuda a planificar un sprint |
bulk_update | Actualiza múltiples Work Items |
project_report | Genera un reporte del proyecto |
report_bug | Crea un Bug report estructurado |
Recursos
| Recurso | URI | Descripción |
|---|
| Estado de conexión | ado://connection/status | Información del estado de conexión actual |
Desarrollo
Requisitos
Instalación local
git clone https://github.com/slorenzot/mcp-azure.git
cd mcp-azure
npm install
npm run build
Scripts disponibles
npm run build # Compila TypeScript
npm run start # Inicia el servidor
npm run dev # Modo desarrollo con watch
Licencia
MIT
Autor
Soulberto Lorenzo - @slorenzot