Azure DevOps Integration MCP Server

Azure DevOps Integration MCP

This Model Context Protocol (MCP) server enables AI assistants to interact with Azure DevOps services via the Python SDK, providing a seamless way to manage projects, work items, repositories, and more.

Installation

1. Clone the repository:

   git clone https://github.com/Vortiago/mcp-azure-devops.git
   cd mcp-azure-devops
   

2. Install the package using your preferred Python package manager:

   pip install -e .
   # or
   uv pip install -e .
   

3. Configure your Azure DevOps credentials:

   • You'll need to set up a Personal Access Token (PAT) with appropriate permissions in Azure DevOps
   • Set the following environment variables:
     • AZURE_DEVOPS_PAT: Your Personal Access Token
     • AZURE_DEVOPS_ORGANIZATION: Your Azure DevOps organization name
     • AZURE_DEVOPS_PROJECT: Your default Azure DevOps project name (optional)

4. Start the MCP server:

   # Using the provided script
   ./start_server.sh
   
   # Or manually
   python -m mcp_azure_devops.server
   

Configuration in AI Assistant

To configure this MCP in your AI assistant (like Claude or other compatible assistants), add the following configuration to your settings:

"mcpServers": {
  "azure-devops": {
    "command": "python",
    "args": [
      "-m",
      "mcp_azure_devops.server"
    ]
  }
}

Usage

Once configured, your AI assistant can interact with Azure DevOps through various tools provided by this MCP. You can:

• Query, create, and update work items
• Manage projects and team configurations
• Access repository information
• Retrieve work item types, templates, and process configurations
• Get project details and team members

The MCP handles authentication and API interactions behind the scenes, allowing the AI assistant to focus on helping you with your Azure DevOps tasks.

Examples

Here are some example interactions you might have with your AI assistant:

• "Show me all active bugs in our current sprint"
• "Create a new user story for implementing feature X"
• "List all projects in our Azure DevOps organization"
• "Update the priority of task #1234 to high"
• "Show me the work item types available in our project"

Troubleshooting

If you encounter issues:

1. Verify your Azure DevOps credentials and environment variables
2. Check the server logs for error messages
3. Ensure your Personal Access Token has the necessary permissions
4. Verify network connectivity to Azure DevOps services

For more detailed information, refer to the repository documentation or open an issue on GitHub.