Azure DevOps MCP Server

🚀 Azure DevOps MCP Server

An implementation of the Model Context Protocol (MCP) server for Azure DevOps, enabling AI assistants to interact with the Azure DevOps API through a standardized protocol.

🚀 Quick Start

Initialize the Server

from mcp_server import Server

# Initialize the basic server
server = Server()

Register Tools

Register custom tools to the server:

class MyCustomTool:
    def execute(self, params):
        # Implement specific tool logic
        pass

server.register_tool("my_custom_tool", MyCustomTool())

Start the Server

Start the MCP server and begin listening for requests:

if __name__ == "__main__":
    server.start()

✨ Features

This server implements the Model Context Protocol (MCP) for Azure DevOps, enabling AI assistants (such as Claude) to securely access and manage Azure DevOps resources. The server serves as a bridge between AI models and the Azure DevOps API, providing a standard way to:

• Access and manage projects, work items, repositories, etc.
• Create and update work items, branches, and pull requests.
• Execute common DevOps workflows through natural language.
• Access repository content via standardized resource URIs.
• Securely authenticate and interact with Azure DevOps resources.

📦 Installation

Install using pip

pip install mcp-server-azure-devops

Clone the repository and install

git clone https://github.com/yourusername/mcp-server-azure-devops.git
cd mcp-server-azure-devops
python setup.py install

📚 Documentation

For the full API documentation and tool implementation details, please refer to the official documentation.

🔧 Technical Details

Server Structure

The server is built around the Model Context Protocol (MCP) for interacting with AI models. It mainly includes the following components:

Core Components

• BaseServer: Provides basic server functions, such as tool registration and logging.
• Brain: Responsible for understanding and processing incoming requests and generating corresponding responses.
• Memory: Manages context information related to interactions.

Functional Modules

• Authentication Module:

  • authenticators: Supports multiple authentication methods, such as token-based and OAuth.
  • identity_resolvers: Resolves user identities into specific identity information.

• Tool Module

  • Provides tools for interacting with Azure DevOps resources, including project management and code repository operations.

Advanced Configuration

Custom Logging

Set different logging levels:

server.set_logger(level="debug")

Extended Functionality

Add more features through extension modules:

from mcp_server import Server, Memory, Brain

class MyExtension:
    def __init__(self):
        self._memory = None

    @property
    def memory(self):
        return self._memory

server = Server()
server.register_extension("my_extension", MyExtension())

🤝 Contribution

Contributions are welcome! Please check CONTRIBUTING.md for contribution guidelines.

📄 License

MIT