🚀 REBUSS.Pure – Token-Efficient AI Code Review for Azure DevOps

Stop sending entire repositories to AI.
Use only what matters: diff + changed files from your Pull Request.

---

💡 What is this?

REBUSS.Pure is a lightweight MCP server that enables AI agents (GitHub Copilot, ChatGPT, Claude):

• 🔍 analyze Azure DevOps Pull Requests
• 📄 access only changed files
• 🧠 perform code review & self-review
• ⚡ use minimal tokens (no full repo scan)

---

🎯 Why this exists

Typical AI workflows:

• ❌ load entire repo
• ❌ waste tokens
• ❌ produce noisy results

This tool:

• ✅ works on diff only
• ✅ loads files on demand
• ✅ enables incremental AI reasoning

👉 designed for real-world large repositories

---

🧠 Core idea

Instead of sending everything to the model:

❌ full repo → LLM

You get:

LLM → MCP → only needed data

---

✨ Key Features

• 🔹 Azure DevOps Pull Request integration
• 🔹 Diff-based AI context (token efficient)
• 🔹 Local self-review (no network required)
• 🔹 No repo cloning needed
• 🔹 Incremental data access
• 🔹 Ready-to-use review prompts
• 🔹 Works with any MCP-compatible agent
• 🔹 Authentication via Azure CLI or PAT
• 🔹 Auto-detects VS Code and Visual Studio

---

🆚 Compared to typical AI workflows

Feature	REBUSS.Pure	Typical approach
Context size	Minimal	Huge
Token usage	Low	High
Setup	1 command	Complex
Signal quality	High	Noisy

---

⚡ Quick Start

1. Install

Option A — .NET global tool (recommended)

dotnet tool install -g REBUSS.Pure

Option B - PowerShell

irm https://raw.githubusercontent.com/rebuss/AzureDevOps.MCP.CodeReview/master/install.ps1 | iex

Option C - Bash

curl -fsSL https://raw.githubusercontent.com/rebuss/AzureDevOps.MCP.CodeReview/master/install.sh | bash

Note: The package is not yet published to NuGet. After the first release, a simple dotnet tool install -g REBUSS.Pure will work.

Prerequisite: .NET 10 SDK or later.

---

2. Initialize in your repo

cd /path/to/your/repo
rebuss-pure init

This will:

• ✔ detect your IDE (VS Code → .vscode/mcp.json, Visual Studio → .vs/mcp.json)
• ✔ generate MCP server configuration
• ✔ copy review prompts to .github/prompts/
• ✔ authenticate via Azure CLI (opens browser for login)

---

3. Review a Pull Request

In Copilot / AI chat:

123 #review-pr

Where 123 is the Azure DevOps Pull Request ID.

---

4. Self-review local changes

#self-review

Works offline — no Azure DevOps connection required.

---

📖 Technical Reference

CLI Commands

rebuss-pure init

Initializes MCP configuration in the current Git repository.

# Default — uses Azure CLI for authentication
rebuss-pure init

# With a Personal Access Token
rebuss-pure init --pat <your-pat>

What it does:

1. Finds the Git repository root
2. Authenticates (Azure CLI or PAT)
3. Detects IDEs and writes mcp.json to the appropriate directory
4. Copies prompt files to .github/prompts/

IDE detection logic:

Markers found	Config written to
.vscode/ or *.code-workspace only	.vscode/mcp.json
.vs/ or *.sln only	.vs/mcp.json
Both or neither	Both locations

---

Server mode (launched automatically by MCP client)

The MCP client starts the server via the generated mcp.json. You can also start it manually:

rebuss-pure --repo /path/to/repo [--pat <token>] [--org <org>] [--project <project>] [--repository <repo-name>]

Argument	Description
--repo	Path to the local Git repository
--pat	Personal Access Token for Azure DevOps
--org	Azure DevOps organization name (auto-detected from Git remote if omitted)
--project	Azure DevOps project name (auto-detected if omitted)
--repository	Azure DevOps repository name (auto-detected if omitted)

---

Authentication

REBUSS.Pure uses a chained authentication strategy. It tries each method in order and uses the first one that succeeds:

1. Personal Access Token (PAT) — explicit config (highest priority)

Provide via CLI:

rebuss-pure init --pat <your-pat>

Or create appsettings.Local.json next to the server executable:

{
  "AzureDevOps": {
    "PersonalAccessToken": "<your-pat-here>"
  }
}

How to create a PAT:

1. Go to https://dev.azure.com/<your-org>/_usersSettings/tokens
2. Click + New Token
3. Select scope: Code (Read)
4. Copy the token

2. Cached token (automatic)

Tokens acquired via Azure CLI are cached locally at:

%LOCALAPPDATA%\REBUSS.Pure\config.json     (Windows)
~/.local/share/REBUSS.Pure/config.json      (Linux/macOS)

Bearer tokens are refreshed automatically when expired.

3. Azure CLI (recommended for interactive use)

If no PAT is configured and no valid cached token exists, the server acquires a token via:

az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798

If Azure CLI is not installed:

• During rebuss-pure init, the tool offers to install it automatically
• Manual install: https://aka.ms/install-azure-cli

4. Error (no auth available)

If none of the above methods work, the server returns a clear error message instructing you to run az login or configure a PAT.

Note: Local self-review (get_local_files, get_local_file_diff) works without any authentication.

---

Configuration

appsettings.json

Located next to the server executable. All fields are optional — auto-detected from Git remote when not specified.

{
  "AzureDevOps": {
    "OrganizationName": "",
    "ProjectName": "",
    "RepositoryName": "",
    "PersonalAccessToken": ""
  }
}

appsettings.Local.json

Same structure as above. Overrides appsettings.json. Excluded from Git via .gitignore. Use this for secrets like PATs.

Environment variables

All settings can be overridden via environment variables:

AzureDevOps__OrganizationName=myorg
AzureDevOps__ProjectName=myproject
AzureDevOps__RepositoryName=myrepo
AzureDevOps__PersonalAccessToken=mytoken

Auto-detection

When OrganizationName, ProjectName, or RepositoryName are not configured, the server automatically detects them from the origin Git remote URL (both HTTPS and SSH formats are supported).

---

MCP Tools Reference

PR Review Tools (require Azure DevOps authentication)

Tool	Description
get_pr_metadata(prNumber)	Returns PR title, author, state, branches, stats, commit SHAs, description
get_pr_files(prNumber)	Returns classified list of changed files with per-file stats and review priority
get_pr_diff(prNumber, [format])	Returns the complete diff for all files in the PR. Use for small PRs
get_file_diff(prNumber, path, [format])	Returns the diff for a single file. Preferred for large PRs
get_file_content_at_ref(path, ref)	Returns full file content at a specific commit/branch/tag

Local Self-Review Tools (no authentication needed)

Tool	Description
get_local_files([scope])	Lists locally changed files with classification metadata
get_local_file_diff(path, [scope])	Returns structured diff for a single locally changed file

Scopes for local tools:

Scope	Description
working-tree (default)	All uncommitted changes (staged + unstaged) vs HEAD
staged	Only staged (indexed) changes vs HEAD
<branch-name>	All commits on current branch not yet merged into <branch-name>

---

Review Workflows

PR Review

get_pr_metadata(prNumber)
  → get_pr_files(prNumber)
    → get_file_diff(prNumber, path)      ← per file, minimal tokens
      → get_file_content_at_ref(path, ref)  ← only when diff is insufficient

Self-Review

get_local_files(scope)
  → get_local_file_diff(path, scope)     ← per file

---

Prompts

After running rebuss-pure init, you get:

.github/prompts/
├── review-pr.md
└── self-review.md

These prompts instruct the AI agent on the review workflow. You can customize them to:

• enforce team coding standards
• adjust review priorities
• change the default self-review scope (default: staged)

---

Logging

Server logs are written to daily-rotated files:

%LOCALAPPDATA%\REBUSS.Pure\server-yyyy-MM-dd.log   (Windows)
~/.local/share/REBUSS.Pure/server-yyyy-MM-dd.log    (Linux/macOS)

Logs older than 3 days are automatically cleaned up.

---

Troubleshooting

"AUTHENTICATION REQUIRED" error

Run az login and restart your IDE, or configure a PAT in appsettings.Local.json.

MCP tools not available in AI chat

1. Ensure rebuss-pure init completed successfully
2. Check that .vscode/mcp.json or .vs/mcp.json exists
3. Restart your IDE or reload the MCP client

Azure DevOps organization/project not detected

If your Git remote uses a non-standard format, specify explicitly:

rebuss-pure --repo . --org myorg --project myproject --repository myrepo

Or configure in appsettings.Local.json:

{
  "AzureDevOps": {
    "OrganizationName": "myorg",
    "ProjectName": "myproject",
    "RepositoryName": "myrepo"
  }
}

Token expired / 203 HTML redirect

The server automatically invalidates stale tokens and retries via Azure CLI. If the issue persists, re-authenticate:

az login

---

📄 License

MIT

---

👤 Author

Michał Korbecki
Creator of REBUSS ecosystem
https://github.com/rebuss/AzureDevOps.MCP.CodeReview