Servidor MCP de Azure DevOps

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para Azure DevOps, que permite que los asistentes de IA interactúen con las API de Azure DevOps a través de un protocolo estandarizado.

Descripción general

Este servidor implementa el Protocolo de Contexto de Modelo (MCP) para Azure DevOps, lo que permite que asistentes de IA como Claude interactúen con los recursos de Azure DevOps de forma segura. El servidor actúa como puente entre los modelos de IA y las API de Azure DevOps, proporcionando una forma estandarizada de:

• Acceda y administre proyectos, elementos de trabajo, repositorios y más
• Crear y actualizar elementos de trabajo, ramas y solicitudes de extracción
• Ejecute flujos de trabajo comunes de DevOps a través del lenguaje natural
• Acceda al contenido del repositorio a través de URI de recursos estandarizados
• Autenticar e interactuar de forma segura con los recursos de Azure DevOps

Estructura del servidor

El servidor se estructura en torno al Protocolo de Contexto de Modelo (MCP) para comunicarse con los asistentes de IA. Proporciona herramientas para interactuar con los recursos de Azure DevOps, incluyendo:

• Proyectos
• Elementos de trabajo
• Repositorios
• Solicitudes de extracción
• Sucursales
• Tuberías

Componentes principales

• AzureDevOpsServer : clase de servidor principal que inicializa el servidor MCP y registra las herramientas
• Controladores de herramientas : funciones modulares para cada operación de Azure DevOps
• Configuración : configuración basada en el entorno para URL de la organización, PAT, etc.

Empezando

Prerrequisitos

• Node.js (v16+)
• npm o hilo
• Cuenta de Azure DevOps con el acceso adecuado
• Credenciales de autenticación (consulte la Guía de autenticación para obtener más detalles):
  • Token de acceso personal (PAT), o
  • Credenciales de identidad de Azure, o
  • Inicio de sesión en la CLI de Azure

Corriendo con NPX

Uso con Claude Desktop/Cursor AI

Para integrarse con Claude Desktop o Cursor AI, agregue una de las siguientes configuraciones a su archivo de configuración.

Autenticación de identidad de Azure

Asegúrese de haber iniciado sesión en la CLI de Azure con az login y luego agregue lo siguiente:

Autenticación mediante token de acceso personal (PAT)

Para obtener instrucciones de configuración detalladas y más opciones de autenticación, consulte la Guía de autenticación .

Métodos de autenticación

Este servidor admite varios métodos de autenticación para conectarse a las API de Azure DevOps. Para obtener instrucciones detalladas de configuración, ejemplos de configuración y sugerencias para la solución de problemas, consulte la Guía de autenticación .

Métodos de autenticación admitidos

1. Token de acceso personal (PAT) : autenticación simple basada en tokens
2. Azure Identity (DefaultAzureCredential) : autenticación flexible mediante el SDK de Azure Identity
3. CLI de Azure : autenticación mediante su inicio de sesión de CLI de Azure

Los archivos de configuración de ejemplo para cada método de autenticación están disponibles en el directorio de ejemplos .

Variables de entorno

Para obtener una lista completa de las variables de entorno y sus descripciones, consulte la Guía de autenticación .

Las variables ambientales clave incluyen:

Solución de problemas de autenticación

Para obtener información detallada sobre la solución de problemas de cada método de autenticación, consulte la Guía de autenticación .

Los problemas comunes incluyen:

• Credenciales inválidas o vencidas
• Permisos insuficientes
• Problemas de conectividad de red
• Errores de configuración

Detalles de la implementación de la autenticación

Para obtener detalles técnicos sobre cómo se implementa la autenticación en el servidor de Azure DevOps MCP, consulte la Guía de autenticación y el código fuente en el directorio src/auth .

Herramientas disponibles

El servidor MCP de Azure DevOps proporciona diversas herramientas para interactuar con los recursos de Azure DevOps. Para obtener documentación detallada sobre cada herramienta, consulte la documentación correspondiente.

Herramientas de usuario

• get_me : Obtener detalles del usuario autenticado (id, nombre para mostrar, correo electrónico)

Herramientas de organización

• list_organizations : Lista todas las organizaciones accesibles

Herramientas del proyecto

• list_projects : enumera todos los proyectos de una organización
• get_project : Obtener detalles de un proyecto específico
• get_project_details : Obtenga detalles completos de un proyecto, incluidos el proceso, los tipos de elementos de trabajo y los equipos

Herramientas de repositorio

• list_repositories : enumera todos los repositorios de un proyecto
• get_repository : Obtener detalles de un repositorio específico
• get_repository_details : Obtenga información detallada sobre un repositorio, incluidas estadísticas y referencias
• get_file_content : Obtener el contenido de un archivo o directorio de un repositorio

Herramientas de elementos de trabajo

• get_work_item : Recuperar un elemento de trabajo por ID
• create_work_item : Crea un nuevo elemento de trabajo
• update_work_item : Actualizar un elemento de trabajo existente
• list_work_items : enumera los elementos de trabajo en un proyecto
• manage_work_item_link : Agregar, eliminar o actualizar vínculos entre elementos de trabajo

Herramientas de búsqueda

• search_code : busca código en los repositorios de un proyecto
• search_wiki : busca contenido en las páginas wiki de un proyecto
• search_work_items : busca elementos de trabajo en todos los proyectos de Azure DevOps

Para obtener documentación completa sobre todas las herramientas, consulte Documentación de herramientas .

Contribuyendo

¡Agradecemos sus contribuciones! Consulte CONTRIBUTING.md para conocer las normas de contribución.

Historia de las estrellas

Licencia

Instituto Tecnológico de Massachusetts (MIT)