Azure DevOps MCP Server for Cline

Servidor MCP de Azure DevOps para Cline

Este servidor de Protocolo de contexto de modelo (MCP) proporciona integración con Azure DevOps, lo que permite a Cline interactuar con los servicios de Azure DevOps.

Prerrequisitos

• Node.js (v20 LTS o superior)
• npm (viene con Node.js)
• Una instalación de Cline
• Cuenta de Azure DevOps con tokens de acceso

Instalación

Instalación mediante herrería

Para instalar Azure DevOps Server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

1. Clonar este repositorio:

2. Instalar dependencias:

3. Construir el servidor:

Nota: La salida de la compilación (directorio build/ ) no se incluye en el control de versiones. Debe ejecutar el comando de compilación después de clonar el repositorio.

Configuración

1. Obtener el token de acceso personal (PAT) de Azure DevOps

1. Vaya a Azure DevOps e inicie sesión
2. Haz clic en tu foto de perfil en la parte superior derecha.
3. Seleccione "Seguridad"
4. Haga clic en "Nuevo token"
5. Dale un nombre a tu token y selecciona los alcances requeridos:
   • Code (read, write) : para operaciones de solicitud de extracción
   • Work Items (read, write) : para la gestión de elementos de trabajo
   • Build (read, execute) : para operaciones de pipeline
   • Wiki (read, write) : para operaciones Wiki
   • Project and Team (read) - Para información sobre Proyecto y Junta Directiva
6. Copiar el token generado

2. Configurar los ajustes de Cline MCP

Agregue la configuración del servidor a su archivo de configuración de Cline MCP:

• Para la extensión de VSCode: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• Para la aplicación de escritorio Claude: %LOCALAPPDATA%/Claude/claude_desktop_config.json

Agregue la siguiente configuración al objeto mcpServers :

Reemplace los siguientes valores:

• /absolute/path/to/azure-devops-server : la ruta absoluta a donde clonó este repositorio
• your-organization : el nombre de su organización de Azure DevOps
• your-project-name : el nombre de su proyecto de Azure DevOps
• your-personal-access-token : El PAT que generaste en el paso 1

Herramientas disponibles

Elementos de trabajo

• get_work_item : Obtener un elemento de trabajo por ID
• list_work_items : Consultar elementos de trabajo mediante WIQL
• create_work_item : Crea un nuevo elemento de trabajo (error, tarea, historia de usuario)
• update_work_item : Actualizar un elemento de trabajo existente

Tableros

• get_boards : Obtener los tableros disponibles en el proyecto

Tuberías

• list_pipelines : enumera todos los pipelines del proyecto
• trigger_pipeline : Ejecutar una canalización

Solicitudes de extracción

• list_pull_requests : Lista de solicitudes de extracción
• create_pull_request : Crea una nueva solicitud de extracción
• update_pull_request : Actualizar una solicitud de extracción
• get_pull_request : Obtener detalles de la solicitud de extracción

Wiki

• get_wikis : enumera todos los wikis del proyecto
• get_wiki_page : Obtener una página wiki
• create_wiki : Crea una nueva wiki
• update_wiki_page : Crea o actualiza una página wiki

Proyectos

• list_projects : enumera todos los proyectos en la organización de Azure DevOps

Verificación

1. Reinicie Cline (o VSCode) después de agregar la configuración
2. El servidor Azure DevOps MCP ahora debería aparecer en las capacidades de Cline
3. Puede verificar la instalación utilizando el Inspector MCP:

Solución de problemas

1. Si el servidor no se conecta:
   • Comprueba que la ruta en la configuración de tu MCP sea correcta
   • Verifique sus credenciales de Azure DevOps
   • Consulte los registros de Cline para ver si hay mensajes de error.
2. Si recibe errores de autenticación:
   • Verifique que su PAT no haya expirado
   • Asegúrese de que el PAT tenga todos los alcances necesarios
   • Verifique nuevamente los nombres de la organización y del proyecto.
3. Para otros asuntos:
   • Ejecute la herramienta de inspección para verificar que el servidor esté funcionando correctamente
   • Verifique los registros del servidor para ver si hay mensajes de error

Desarrollo

Para modificar o ampliar el servidor:

1. Realice sus cambios en el directorio src
2. Ejecutar npm run watch para desarrollo
3. Construya con npm run build cuando esté listo
4. Prueba usando el inspector: npm run inspector

Licencia

Licencia MIT: consulte LICENCIA para obtener más detalles