MCP Azure DevOps Server

🚀 MCP Azure DevOps Server

A server implementing the Model Context Protocol (MCP) that enables AI assistants to interact with Azure DevOps services.

🚀 Quick Start

Prerequisites

• Python version 3.10 or higher.
• An Azure DevOps account with appropriate permissions.
• A Personal Access Token (PAT) with the required scopes.

Installation

# Clone the repository
git clone https://github.com/Vortiago/mcp-azure-devops.git
cd mcp-azure-devops

# Install in development mode
uv pip install -e ".[dev]"

# Install from PyPi
pip install mcp-azure-devops

Configuration

Create a .env file in the project root directory containing the following variables:

AZURE_DEVOPS_PAT=your_personal_access_token
AZURE_DEVOPS_ORGANIZATION_URL=https://your-organization.visualstudio.com or https://dev.azure.com/your-organisation

Note: Please provide the full URL of your organization.

Running the Server

# Use in development mode with MCP monitor
mcp dev src/mcp_azure_devops/server.py

# Install in Claude Desktop
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

✨ Features

Implemented Features

Work Item Management

• Query Work Items: Search for work items using WIQL queries.
• Get Work Item Details: View full work item information.
• Create Work Items: Add new tasks, bugs, user stories, and other types of work items.
• Update Work Items: Modify fields and properties of existing work items.
• Add Comments: Post comments on work items.
• View Comments: Retrieve the comment history of work items.
• Parent-Child Relationships: Establish hierarchical structures between work items.

Project Management

• Get Projects: View all accessible projects in the organization.
• Get Teams: List all teams in the organization.
• Team Members: View team member information.
• Team Area Paths: Retrieve the area paths assigned to teams.
• Team Iterations: Access the iteration/sprint configuration of teams.

Planned Features

• Pipeline Operations: Query pipeline status and trigger new pipeline runs.
• Pull Request Handling: Create, update, and review pull requests.
• Sprint Management: Plan and manage sprints and iterations.
• Branch Policy Management: Configure and manage branch policies.

💻 Usage Examples

Query Work Items

Show all active bugs assigned to me in the current sprint.

Create Work Items

Create a user story titled "Implement user authentication" in ProjectX and assign it to john.doe@example.com.

Update Work Items

Change the status of bug #1234 to "Resolved" and add a comment explaining the fix.

Team Management

Show information about all members of the "Core Development" team in ProjectX.

View Project Structure

List all projects in my organization and show the iteration configuration of the Development team.

📚 Documentation

This project is developed by functional modules, with each module implementing specific Azure DevOps functions:

• features/work_items: Work item management functions.
• features/projects: Project management functions.
• features/teams: Team management functions.
• utils: Common utilities and client initialization.

For more development information, please refer to the CLAUDE.md file.

🤝 Contribution

We welcome contributions from the community! If you have any questions, suggestions, or fixes, please submit a pull request or issue. Please read our Contribution Guidelines before submitting code.

📄 License

This project is distributed under the MIT License.

📞 Contact

If you have any questions, please contact the project maintainers: contact information.

Thank you for your interest in the MCP Azure DevOps Server! We look forward to your feedback and contributions.