MCP Server Azure Devops

🚀 Azure DevOps MCP Server

Azure DevOps MCP Server provides a powerful platform for managing and operating Azure DevOps services. This document details its features, configuration guides, and usage instructions.

🚀 Quick Start

Azure DevOps MCP Server, based on the Model Context Protocol (MCP), aims to simplify and automate the development and collaboration processes in the Azure DevOps environment. By integrating various tools and services, this platform offers a comprehensive solution from code management to continuous integration/delivery.

📦 Installation

Installation Steps

• Download and install the latest version of Azure DevOps MCP Server.
• Complete the basic configuration following the installation wizard, including selecting the installation location and components.

Network Configuration

• Configure network settings to ensure the server can access external resources and services.
• Configure firewall rules to allow necessary ports and traffic.

💻 Usage Examples

User Tools

• get_me: Retrieve detailed information (ID, display name, email) of the authenticated user.

Organization Tools

• list_organizations: List all organizations accessible to the user.

Project Tools

• list_projects: List all projects within a specified organization.
• get_project: Get detailed information about a specific project.
• get_project_details: Obtain comprehensive project details, including processes, work item types, and team information.

Repository Tools

• list_repositories: List all code repositories in a project.
• get_repository: Get detailed information about a specific code repository.
• get_repository_details: Obtain detailed information about a code repository, including statistics and references.
• get_file_content: Retrieve the content of a file or directory in a code repository.

Work Item Tools

• get_work_item: Retrieve a work item by ID.
• create_work_item: Create a new work item.
• update_work_item: Update an existing work item.
• list_work_items: List all work items in a project.
• manage_work_item_link: Manage links between work items (add, delete, or update).

Search Tools

• search_code: Search for code in the code repositories of a project.
• search_wiki: Search for content in the wiki pages of a project.
• search_work_items: Search for work items in all projects within an organization.

Pipeline Tools

• create_pipelines: Create new build pipelines.
• list_pipelines: List all pipelines in a project.
• get_pipeline: Get detailed information about a specific pipeline.
• trigger_pipeline: Trigger a pipeline run with support for custom parameter settings.

Wiki Tools

• get_wikis: List all wikis in a project.
• get_wiki_page: Retrieve the content of a specified wiki page (in plain text format).

Pull Request Tools

• create_pull_request: Create a new pull request in a code repository.
• list_pull_requests: List and filter pull requests in a project or code repository.

🔧 Technical Details

Authentication Methods

• Token-based authentication: Use OAuth or Azure AD tokens for authentication.
• Certificate-based authentication: Support secure communication using SSL certificates.

Environment Variables

The following are the key environment variables and their functions:

• AZURE_DEVOPS_ORG_URL: Specify the URL of the target organization.
• AZURE_DEVOPS_PROJECT_NAME: Specify the project name.
• AZURE_DEVOPS_PAT: Use a personal access token for authentication.

Troubleshooting

Common issues include:

• Authentication failure: Check if the token is valid and has sufficient permissions.
• Network connection issues: Ensure the network is unobstructed and no firewall blocks communication.
• Insufficient permissions: Confirm that the user has the necessary permissions to perform the operation.

Logging

The server supports multiple log levels (debug, info, warning, error), with the default level set to "info". Log files are located in the "log" folder of the installation directory.

Performance Monitoring

Real-time monitoring of server performance and running status can be achieved through integration with Azure Monitor.

Security Best Practices

• Regular updates: Follow the vendor's recommendations to update to the latest version promptly for security patches.
• Principle of least privilege: Assign the minimum necessary permissions to each user to reduce potential security risks.
• Encrypted communication: Ensure all communication uses SSL/TLS encryption.

Extension and Integration

• Plugin development: Developers can create custom plugins to extend server functionality. Refer to the official documentation for detailed information.
• Third-party tool integration: Support seamless integration with other popular development tools and CI/CD tools (e.g., Jenkins, GitHub Actions).

Support and Resources

• Official documentation: Provides detailed API documentation and technical guides.
• Community forum: Participate in the active developer community to get help and share experiences.
• Technical support: Contact the Azure support team to resolve difficult issues.

📄 Conclusion

Azure DevOps MCP Server offers an efficient, secure, and scalable collaboration platform for development teams by integrating various functions and services. By following the guidelines in this document, you can fully leverage the server's powerful features to enhance development efficiency and project quality.