@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)

1. Ve a tu organización de Azure DevOps
2. Haz clic en tu avatar (esquina superior derecha)
3. Selecciona Personal Access Tokens
4. 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

• Node.js 18+
• npm o yarn

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