Metadata-Version: 2.4
Name: py-azure-devops-mcp
Version: 0.1.1
Summary: MCP Server for Azure DevOps integration with AI agents
Author-email: "ZenProgramming.it" <zenprogramming.it@gmail.com>
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: py-azure-devops-sdk
Requires-Dist: fastmcp<1.0.0
Dynamic: license-file

# py-azure-devops-mcp

MCP Server implementation for Azure DevOps, enabling AI agents to manage work items.

## Installation

```bash
pip install py-azure-devops-mcp
```

## Configuration

The server requires the following **required** environment variables:

```env
AZURE_DEVOPS_MCP_TENANT_ID="your-tenant-id"
AZURE_DEVOPS_MCP_PROJECT_NAME="your-project-name"
AZURE_DEVOPS_MCP_PAT="your-pat"
```

If your Azure DevOps organization has work item with **custom fields**, the following environment variable is also needed:

```env
AZURE_DEVOPS_MCP_CUSTOM_PROPS="{'custom_field_one': 'Custom.AliasFieldOne'}"
```

## Usage with AI Agents

You can run the server using the python module:
```bash
python -m py_azure_devops_mcp.server
```

### OpenCode Configuration (`opencode.jsonc`)
Add this to your configuration:
```jsonc
{
  "mcp": {
    "py-azure-devops-mcp": {
      "type": "local",
      "command": [
        "python",
        "-m",
        "py_azure_devops_mcp.server"
      ], 
      "environment": {
        "AZURE_DEVOPS_MCP_TENANT_ID": "your-tenant-id",
        "AZURE_DEVOPS_MCP_PROJECT_NAME": "your-project-name",
        "AZURE_DEVOPS_MCP_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_MCP_CUSTOM_PROPS": "{'custom_field_one': 'Custom.AliasFieldOne'}"
      }
    }
  }
}
```

### Claude Code Configuration
Add this to your configuration:
```json
{
  "mcpServers": {
    "py-azure-devops-mcp": {
      "command": "python",
      "args": ["-m", "py_azure_devops_mcp.server"],
      "env": {
        "AZURE_DEVOPS_MCP_TENANT_ID": "your-tenant-id",
        "AZURE_DEVOPS_MCP_PROJECT_NAME": "your-project-name",
        "AZURE_DEVOPS_MCP_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_MCP_CUSTOM_PROPS": "{'custom_field_one': 'Custom.AliasFieldOne'}"
      }
    }
  }
}
```

## Architecture
This server acts as a wrapper around `py-azure-devops-sdk`, exposing its functionality as MCP tools.
