mcp-server-azure-devops

# Azure DevOps MCP Server A Model Context Protocol (MCP) server implementation for Azure DevOps, allowing AI assistants to interact with Azure DevOps APIs through a standardized protocol. ## Overview This server implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) for Azure DevOps, enabling AI assistants like Claude to interact with Azure DevOps resources securely. The server acts as a bridge between AI models and Azure DevOps APIs, providing a standardized way to: - Access and manage projects, work items, repositories, and more - Create and update work items, branches, and pull requests - Execute common DevOps workflows through natural language - Access repository content via standardized resource URIs - Safely authenticate and interact with Azure DevOps resources ## Server Structure The server is structured around the Model Context Protocol (MCP) for communicating with AI assistants. It provides tools for interacting with Azure DevOps resources including: - Projects - Work Items - Repositories - Pull Requests - Branches - Pipelines ### Core Components - **AzureDevOpsServer**: Main server class that initializes the MCP server and registers tools - **Feature Modules**: Organized by feature area (work-items, projects, repositories, etc.) - **Request Handlers**: Each feature module provides request identification and handling functions - **Tool Handlers**: Modular functions for each Azure DevOps operation - **Configuration**: Environment-based configuration for organization URL, PAT, etc. The server uses a feature-based architecture where each feature area (like work-items, projects, repositories) is encapsulated in its own module. This makes the codebase more maintainable and easier to extend with new features. ## Getting Started ### Prerequisites - Node.js (v16+) - npm or yarn - Azure DevOps account with appropriate access - Authentication credentials (see [Authentication Guide](https://github.com/tiberriver256/mcp-server-azure-devops/blob/main/docs/authentication.md) for details): - Personal Access Token (PAT), or - Azure Identity credentials, or - Azure CLI login ### Running with NPX After building the project with `npm run build`, you can run the server directly with: ```bash npx @tiberriver256/mcp-server-azure-devops ``` ### Usage with Claude Desktop/Cursor AI To integrate with Claude Desktop or Cursor AI, add one of the following configurations to your configuration file. #### Azure Identity Authentication Be sure you are logged in to Azure CLI with `az login` then add the following: ```json { "mcpServers": { "azureDevOps": { "command": "npx", "args": ["-y", "@tiberriver256/mcp-server-azure-devops"], "env": { "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization", "AZURE_DEVOPS_AUTH_METHOD": "azure-identity", "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name" } } } } ``` #### Personal Access Token (PAT) Authentication ```json { "mcpServers": { "azureDevOps": { "command": "npx", "args": ["-y", "@tiberriver256/mcp-server-azure-devops"], "env": { "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization", "AZURE_DEVOPS_AUTH_METHOD": "pat", "AZURE_DEVOPS_PAT": "<YOUR_PAT>", "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name" } } } } ``` For detailed configuration instructions and more authentication options, see the [Authentication Guide](https://github.com/tiberriver256/mcp-server-azure-devops/blob/main/docs/authentication.md). ## Authentication Methods This server supports multiple authentication methods for connecting to Azure DevOps APIs. For detailed setup instructions, configuration examples, and troubleshooting tips, see the [Authentication Guide](https://github.com/tiberriver256/mcp-server-azure-devops/blob/main/docs/authentication.md). ### Supported Authentication Methods 1. **Personal Access Token (PAT)** - Simple token-based authentication 2. **Azure Identity (DefaultAzureCredential)** - Flexible authentication using the Azure Identity SDK 3. **Azure CLI** - Authentication using your Azure CLI login Example configuration files for each authentication method are available in the [examples directory](https://github.com/tiberriver256/mcp-server-azure-devops/tree/main/docs/examples). ## Environment Variables For a complete list of environment variables and their descriptions, see the [Authentication Guide](https://github.com/tiberriver256/mcp-server-azure-devops/blob/main/docs/authentication.md#configuration-reference). Key environment variables include: | Variable | Description | Required | Default | | ------------------------------ | ---------------------------------------------------------------------------------- | ---------------------------- | ---------------- | |