# Clone or navigate to the project
cd ado-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
pip install -e .

# Copy the example
cp .env.example .env

# Edit with your values
ADO_ORGANIZATION_URL=https://dev.azure.com/YourOrganization
ADO_PAT=your_personal_access_token
ADO_DEFAULT_PROJECT=YourDefaultProject  # Optional
LOG_LEVEL=INFO

# Run directly
python -m ado_mcp.server

# Or use the CLI command
ado-mcp

{
  "mcpServers": {
    "azure-devops": {
      "command": "python",
      "args": ["-m", "ado_mcp.server"],
      "cwd": "/path/to/ado-mcp",
      "env": {
        "ADO_ORGANIZATION_URL": "https://dev.azure.com/YourOrg",
        "ADO_PAT": "your_pat_here",
        "ADO_DEFAULT_PROJECT": "YourProject"
      }
    }
  }
}

"Get details of work item #1234"
"Show me all active tasks assigned to me"
"Create a new bug: Login button not working on mobile"
"Update work item #1234 to Resolved with comment 'Fixed in PR #567'"

"List all repositories in the project"
"Analyze the backend-api repository"
"Show me the folder structure of frontend-app"
"Get the content of /src/main.py from backend-api"

"List all wikis in the project"
"Get the content of the /Home wiki page"
"Create a wiki page for the new authentication feature"

"I want to work on PBI #1234, analyze it and suggest a repository"
"Generate an implementation plan for task #5678"
"Update work item #1234 with 50% progress"

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# With coverage
pytest tests/ -v --cov=src/ado_mcp

# Lint and format
ruff check src/
ruff format src/

# Type checking
mypy src/

ado-mcp/
├── src/ado_mcp/
│   ├── __init__.py
│   ├── server.py           # MCP server entry point
│   ├── config.py           # Configuration management
│   ├── ado_client.py       # Azure DevOps API client
│   ├── tools/              # MCP Tools
│   │   ├── work_items.py   # Work item operations
│   │   ├── repositories.py # Repository operations
│   │   ├── wiki.py         # Wiki operations
│   │   └── analysis.py     # AI workflow analysis
│   ├── resources/          # MCP Resources
│   │   └── projects.py     # Project resources
│   └── prompts/            # MCP Prompts
│       └── workflows.py    # Workflow templates
├── tests/                  # Test files
├── pyproject.toml          # Project configuration
├── .env.example            # Environment template
└── README.md               # This file