mcp-azure-tfvc

MCP (Model Context Protocol) server for Azure DevOps Team Foundation Version Control — read-only access.

Lets AI assistants (Claude Desktop, Gemini, etc.) browse TFVC source trees, read file contents, and inspect changesets via structured tools.

Setup

1. Install dependencies

npm install

2. Configure environment

Copy .env.example to .env and fill in your values:

AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
AZURE_DEVOPS_PAT=your_personal_access_token
AZURE_DEVOPS_PROJECT=YourProjectName

PAT Scope required: Code → Read only.

3. Run the server

node src/index.js

Registering with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tfvc": {
      "command": "npx",
      "args": [
        "mcp-azure-tfvc"
      ],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-org",
        "AZURE_DEVOPS_PAT": "your_pat",
        "AZURE_DEVOPS_PROJECT": "YourProject"
      }
    }
  }
}

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node src/index.js

Available Tools

| Tool | Description | |---|---| | tfvc_list_items | List files/folders at a TFVC path. Supports None, OneLevel, Full recursion. | | tfvc_get_file_content | Read the content of a file at a given TFVC path. | | tfvc_list_changesets | List recent changesets. Filter by path, author, date range, max count. | | tfvc_get_changeset | Full details of a changeset — file changes, work items, check-in notes. | | tfvc_get_item_versions | History of a specific file/folder path (which changesets touched it). |

Example Tool Calls

List root folders:

{ "tool": "tfvc_list_items", "arguments": { "scopePath": "$/", "recursionLevel": "OneLevel" } }

Read a file:

{ "tool": "tfvc_get_file_content", "arguments": { "path": "$/ProjectName/filePath" } }

Latest 10 changesets:

{ "tool": "tfvc_list_changesets", "arguments": { "maxCount": 10 } }

Changeset details:

{ "tool": "tfvc_get_changeset", "arguments": { "changesetId": 12345 } }

File history:

{ "tool": "tfvc_get_item_versions", "arguments": { "itemPath": "$/ProjectName/filePath" } }