https://github.com/Vortiago/mcp-azure-devops
A Model Context Protocol (MCP) server enabling AI assistants to interact with Azure DevOps services via Python SDK.
https://github.com/Vortiago/mcp-azure-devops
Last synced: 3 months ago
JSON representation
A Model Context Protocol (MCP) server enabling AI assistants to interact with Azure DevOps services via Python SDK.
- Host: GitHub
- URL: https://github.com/Vortiago/mcp-azure-devops
- Owner: Vortiago
- License: mit
- Created: 2025-03-13T18:14:14.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-29T07:04:43.000Z (4 months ago)
- Last Synced: 2025-03-29T08:19:31.446Z (4 months ago)
- Language: Python
- Size: 138 KB
- Stars: 4
- Watchers: 3
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Azure DevOps Assistant - Interact with Azure DevOps services to manage work items, pipelines, and pull requests through natural language commands. Supports tasks such as querying, creating, updating work items, and managing comments. (Task and Project Management)
- awesome-devops-mcp-servers - Vortiago/mcp-azure-devops - A Model Context Protocol server enabling AI assistants to interact with Azure DevOps services via Python SDK. (Cloud Infrastructure / ☁️ Cloud Providers)
- awesome-devops-mcp-servers - Vortiago/mcp-azure-devops - A Model Context Protocol server enabling AI assistants to interact with Azure DevOps services via Python SDK. (Cloud Infrastructure / ☁️ Cloud Providers)
- awesome-mcp-servers - Azure DevOps - A Model Context Protocol (MCP) server enabling AI assistants to interact with Azure DevOps services via Python SDK. (Table of Contents / Developer Tools)
- awesome-mcp-servers - Azure DevOps - A Model Context Protocol (MCP) server enabling AI assistants to interact with Azure DevOps services via Python SDK. (Table of Contents / Developer Tools)
README
# MCP Azure DevOps Server
A Model Context Protocol (MCP) server enabling AI assistants to interact with Azure DevOps services.
## Overview
This project implements a Model Context Protocol (MCP) server that allows AI assistants (like Claude) to interact with Azure DevOps, providing a bridge between natural language interactions and the Azure DevOps REST API.
## Features
Currently implemented:
### Work Item Management
- **Query Work Items**: Search for work items using WIQL queries
- **Get Work Item Details**: View complete work item information
- **Create Work Items**: Add new tasks, bugs, user stories, and other work item types
- **Update Work Items**: Modify existing work items' fields and properties
- **Add Comments**: Post comments on work items
- **View Comments**: Retrieve the comment history for a work item
- **Parent-Child Relationships**: Establish hierarchy between work items
### Project Management
- **Get Projects**: View all accessible projects in the organization
- **Get Teams**: List all teams within the organization
- **Team Members**: View team membership information
- **Team Area Paths**: Retrieve area paths assigned to teams
- **Team Iterations**: Access team iteration/sprint configurations
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 Administration**: Configure and manage branch policies
## Getting Started
### Prerequisites
- Python 3.10+
- Azure DevOps account with appropriate permissions
- Personal Access Token (PAT) with necessary scopes for Azure DevOps API access
### Installation
```bash
# 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 with 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: Make sure to provide the full URL to your Azure DevOps organization.
### Running the Server
```bash
# Development mode with the MCP Inspector
mcp dev src/mcp_azure_devops/server.py
# Install in Claude Desktop
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"
```
## Usage Examples
### Query Work Items
```
Show me all active bugs assigned to me in the current sprint
```
### Create a Work Item
```
Create a user story in the ProjectX with the title "Implement user authentication" and assign it to [email protected]
```
### Update a Work Item
```
Change the status of bug #1234 to "Resolved" and add a comment explaining the fix
```
### Team Management
```
Show me all the team members in the "Core Development" team in the "ProjectX" project
```
### View Project Structure
```
List all projects in my organization and show me the iterations for the Development team
```
## Development
The project is structured into feature modules, each implementing specific Azure DevOps capabilities:
- `features/work_items`: Work item management functionality
- `features/projects`: Project management capabilities
- `features/teams`: Team management features
- `utils`: Common utilities and client initialization
For more information on development, see the [CLAUDE.md](CLAUDE.md) file.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- Built with [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)
- Uses [Azure DevOps Python API](https://github.com/microsoft/azure-devops-python-api)