{"_id":"azure-devops-mcp","_rev":"6-63daa3c222fd07bb0592fd5c77f4eb72","name":"azure-devops-mcp","dist-tags":{"latest":"1.1.2"},"versions":{"1.0.0":{"name":"azure-devops-mcp","version":"1.0.0","keywords":["mcp","azure-devops","tfs","azure-devops-server","model-context-protocol","claude","ai","devops"],"author":{"name":"Nof Yonany"},"license":"MIT","_id":"azure-devops-mcp@1.0.0","maintainers":[{"name":"elad-nofy","email":"nofy@elad-health.com"}],"homepage":"https://github.com/elad-nofy/azure-devops-mcp#readme","bugs":{"url":"https://github.com/elad-nofy/azure-devops-mcp/issues"},"bin":{"azure-devops-mcp":"dist/index.js"},"dist":{"shasum":"09971c59e78e5317c563abda21ff0983425b9974","tarball":"https://registry.npmjs.org/azure-devops-mcp/-/azure-devops-mcp-1.0.0.tgz","fileCount":46,"integrity":"sha512-qR8RK9Yfp6gqTJXZJQXS6TiBK5FTtXbnnCk8A+Vv67VVqS++Sb+PWfh0BohzRQKYKS1xOW+6v1HnqP7K9/B1bA==","signatures":[{"sig":"MEYCIQCNRDV7KZ1YJYIzrc4V3YDXubygsP/OyVY157NFwvALoAIhAKgqZgg3dyZMMB0yaMIKiK1/aAAHxOL8EmRBeVJ8YQam","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":205337},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"71602624c2d1d46946c39b1ddcf97727e795f1f1","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"elad-nofy","email":"nofy@elad-health.com"},"repository":{"url":"git+https://github.com/elad-nofy/azure-devops-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Azure DevOps Server 2022 / TFS - READ-ONLY access to builds, work items, releases, git, pipelines, and test results","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.24.1","azure-devops-node-api":"^14.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/azure-devops-mcp_1.0.0_1767648777289_0.9976782196126457","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"azure-devops-mcp","version":"1.1.0","keywords":["mcp","azure-devops","tfs","azure-devops-server","model-context-protocol","claude","ai","devops"],"author":{"name":"Nof Yonany"},"license":"MIT","_id":"azure-devops-mcp@1.1.0","maintainers":[{"name":"elad-nofy","email":"nofy@elad-health.com"}],"homepage":"https://github.com/elad-nofy/azure-devops-mcp#readme","bugs":{"url":"https://github.com/elad-nofy/azure-devops-mcp/issues"},"bin":{"azure-devops-mcp":"dist/index.js"},"dist":{"shasum":"c56a5bc4d5f94cd1cd3a3b0549ed8ac3d9a47258","tarball":"https://registry.npmjs.org/azure-devops-mcp/-/azure-devops-mcp-1.1.0.tgz","fileCount":46,"integrity":"sha512-FmO//OJUmrWNfXGi7ms61loQ8AF9Wykr7tmQjeZIOUK7ivRGUDCQu6lO5U9hMlpil2Z1SyIkdj+GCvnbMOy+gQ==","signatures":[{"sig":"MEYCIQCBCVtZ5ctsRRt4Sm3gYmMwKyPmOgkdHoIa+fUvzbmF/QIhAPi7zPnntnEvFNQ0L5vRhNUUCCL0gkqArGi2k9qPdmMr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/azure-devops-mcp@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":219957},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"1890f68da34e489a85a18d377c79a866ef8803bf","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b40e721c-6eb9-4739-9527-0a560d6a3374"}},"repository":{"url":"git+https://github.com/elad-nofy/azure-devops-mcp.git","type":"git"},"_npmVersion":"11.7.0","description":"MCP server for Azure DevOps Server 2022 / TFS - READ-ONLY access to builds, work items, releases, git, pipelines, and test results","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.24.1","zod-to-json-schema":"^3.25.1","azure-devops-node-api":"^14.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/azure-devops-mcp_1.1.0_1767657633113_0.4345226043175907","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"azure-devops-mcp","version":"1.1.1","keywords":["mcp","azure-devops","tfs","azure-devops-server","model-context-protocol","claude","ai","devops"],"author":{"name":"Nof Yonany"},"license":"MIT","_id":"azure-devops-mcp@1.1.1","maintainers":[{"name":"elad-nofy","email":"nofy@elad-health.com"}],"homepage":"https://github.com/elad-nofy/azure-devops-mcp#readme","bugs":{"url":"https://github.com/elad-nofy/azure-devops-mcp/issues"},"bin":{"azure-devops-mcp":"dist/index.js"},"dist":{"shasum":"a306e51c0ae9d0f34f2fddbdb00871cbca67c22b","tarball":"https://registry.npmjs.org/azure-devops-mcp/-/azure-devops-mcp-1.1.1.tgz","fileCount":46,"integrity":"sha512-sOibQRHMlaMXvkEE9MtueU3QPvrSNDylBdS5Qpcp+UdkezZYBY8uDJxdyhZj7KJS/MDb0ItWkB0sz6DKIv+KkQ==","signatures":[{"sig":"MEUCIGOHc6L0LmVYzvejdf03UrMVaowtXhf/ibLlEh3pxkvcAiEAkmS6nkKu+0CpL0GHNzBzJrtcY9It5vtUlSX66M7Srm0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/azure-devops-mcp@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":219875},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"8ec843894ead01ded698cafd01171961e1e27c72","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b40e721c-6eb9-4739-9527-0a560d6a3374"}},"repository":{"url":"git+https://github.com/elad-nofy/azure-devops-mcp.git","type":"git"},"_npmVersion":"11.7.0","description":"MCP server for Azure DevOps Server 2022 / TFS - READ-ONLY access to builds, work items, releases, git, pipelines, and test results","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.24.1","zod-to-json-schema":"^3.25.1","azure-devops-node-api":"^14.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/azure-devops-mcp_1.1.1_1767660065993_0.2929402280344182","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"azure-devops-mcp","version":"1.1.2","description":"MCP server for Azure DevOps Server 2022 / TFS - READ-ONLY access to builds, work items, releases, git, pipelines, and test results","main":"dist/index.js","type":"module","bin":{"azure-devops-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc --watch","prepublishOnly":"npm run build"},"keywords":["mcp","azure-devops","tfs","azure-devops-server","model-context-protocol","claude","ai","devops"],"author":{"name":"Nof Yonany"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/elad-nofy/azure-devops-mcp.git"},"bugs":{"url":"https://github.com/elad-nofy/azure-devops-mcp/issues"},"homepage":"https://github.com/elad-nofy/azure-devops-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","azure-devops-node-api":"^14.1.0","zod":"^3.24.1","zod-to-json-schema":"^3.25.1"},"devDependencies":{"@types/node":"^22.10.5","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"gitHead":"cfc747edc5488644080bfd41c1de69a93a02ff19","types":"./dist/index.d.ts","_id":"azure-devops-mcp@1.1.2","_nodeVersion":"22.21.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-p02IsU2E70cCn/D3CwKpkuj2xDpCmQo4EGQna6sHjlEB3O/hZXyLxkjizPHEg77dd/A8TiyMlONFxELIoHyFKg==","shasum":"aba55afb46463d65b90e15ba5d9fb279286ed315","tarball":"https://registry.npmjs.org/azure-devops-mcp/-/azure-devops-mcp-1.1.2.tgz","fileCount":46,"unpackedSize":219873,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/azure-devops-mcp@1.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBb0Z9tA0vArHvaG/hh1gunt9sVlTEW5RhVfcQelTeYxAiEA4mjno1WzWeSPPBz3f5LQdYc8HNTeIQYZWNC9Khy9o9Y="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b40e721c-6eb9-4739-9527-0a560d6a3374"}},"directories":{},"maintainers":[{"name":"elad-nofy","email":"nofy@elad-health.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/azure-devops-mcp_1.1.2_1769104041766_0.12020614747088287"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-05T21:32:57.198Z","modified":"2026-01-22T17:47:22.212Z","0.1.0":"2025-04-25T20:18:42.761Z","1.0.0":"2026-01-05T21:32:57.424Z","1.1.0":"2026-01-06T00:00:33.272Z","1.1.1":"2026-01-06T00:41:06.148Z","1.1.2":"2026-01-22T17:47:21.943Z"},"bugs":{"url":"https://github.com/elad-nofy/azure-devops-mcp/issues"},"author":{"name":"Nof Yonany"},"license":"MIT","homepage":"https://github.com/elad-nofy/azure-devops-mcp#readme","keywords":["mcp","azure-devops","tfs","azure-devops-server","model-context-protocol","claude","ai","devops"],"repository":{"type":"git","url":"git+https://github.com/elad-nofy/azure-devops-mcp.git"},"description":"MCP server for Azure DevOps Server 2022 / TFS - READ-ONLY access to builds, work items, releases, git, pipelines, and test results","maintainers":[{"name":"elad-nofy","email":"nofy@elad-health.com"}],"readme":"# Azure DevOps MCP Server\n\nA **READ-ONLY** MCP (Model Context Protocol) server that connects AI assistants to Azure DevOps Server (on-premises). Works with Claude Code CLI, VS Code AI extensions (Continue, Cline), Cursor, and any MCP-compatible client.\n\n## Features\n\n- **Projects**: List and explore projects\n- **Git/Repos**: Browse repositories, commits, branches, pull requests, diffs, and code search\n- **Builds**: List builds, view logs, analyze errors\n- **Work Items**: Query work items, find linked commits/PRs\n- **Releases**: View releases and deployment status\n- **Pipelines**: List YAML pipelines, view runs, get pipeline configuration\n- **Test Results**: View test runs, results, and analyze failures\n\n## Prerequisites\n\n- Node.js 18 or higher\n- Azure DevOps Server 2020 or 2022 (on-premises)\n- Personal Access Token (PAT) with read scopes\n\n## Installation\n\n### Option 1: npm (Recommended)\n\n```bash\nnpx azure-devops-mcp@latest\n```\n\n### Option 2: Clone and Build\n\n```bash\ngit clone https://github.com/elad-nofy/azure-devops-mcp.git\ncd azure-devops-mcp\nnpm install\nnpm run build\n```\n\n## Configuration\n\n### Create a Personal Access Token (PAT)\n\n1. Go to Azure DevOps Server\n2. Click on your profile icon > Security > Personal access tokens\n3. Create a new token with the following scopes:\n   - **Code**: Read\n   - **Build**: Read\n   - **Work Items**: Read\n   - **Release**: Read\n   - **Test Management**: Read\n\n### Configure MCP Client\n\n#### Claude Code CLI\n\nAdd to your global settings (`~/.claude.json` on macOS/Linux, `%USERPROFILE%\\.claude.json` on Windows):\n\n**Windows:**\n```json\n{\n  \"mcpServers\": {\n    \"azure-devops\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/c\", \"npx\", \"azure-devops-mcp\"],\n      \"env\": {\n        \"AZURE_DEVOPS_URL\": \"http://your-tfs-server:8080/tfs\",\n        \"AZURE_DEVOPS_PAT\": \"your-personal-access-token\",\n        \"AZURE_DEVOPS_COLLECTION\": \"YourCollection\",\n        \"AZURE_DEVOPS_PROJECT\": \"YourDefaultProject\"\n      }\n    }\n  }\n}\n```\n\n**macOS / Linux:**\n```json\n{\n  \"mcpServers\": {\n    \"azure-devops\": {\n      \"command\": \"npx\",\n      \"args\": [\"azure-devops-mcp\"],\n      \"env\": {\n        \"AZURE_DEVOPS_URL\": \"http://your-tfs-server:8080/tfs\",\n        \"AZURE_DEVOPS_PAT\": \"your-personal-access-token\",\n        \"AZURE_DEVOPS_COLLECTION\": \"YourCollection\",\n        \"AZURE_DEVOPS_PROJECT\": \"YourDefaultProject\"\n      }\n    }\n  }\n}\n```\n\n#### VS Code (Continue/Cline)\n\nAdd similar configuration to the extension's MCP settings.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `AZURE_DEVOPS_URL` | Yes | Server base URL (e.g., `http://tfs:8080/tfs`) |\n| `AZURE_DEVOPS_PAT` | Yes | Personal Access Token |\n| `AZURE_DEVOPS_COLLECTION` | No | Collection name (default: `DefaultCollection`) |\n| `AZURE_DEVOPS_PROJECT` | No | Default project for commands |\n\n## Available Tools\n\n### Projects\n| Tool | Description |\n|------|-------------|\n| `test_connection` | Test connection to Azure DevOps and verify authentication |\n| `list_projects` | List all projects in the organization |\n| `get_project` | Get detailed project information |\n\n### Git / Repositories\n| Tool | Description |\n|------|-------------|\n| `list_repos` | List repositories in a project |\n| `list_branches` | List branches in a repository |\n| `list_commits` | Get commit history with filters |\n| `get_commit` | Get commit details with changes |\n| `get_commit_diff` | Get file diff for a commit |\n| `list_pull_requests` | List pull requests |\n| `get_pull_request` | Get PR details with comments |\n| `compare_branches` | Compare two branches (regression analysis) |\n| `search_code` | Search for text in repository files |\n| `get_file_content` | Get file content from a repo at a specific branch/commit |\n| `get_commits_for_work_item` | Find commits referencing a work item |\n| `get_prs_for_work_item` | Find PRs linked to a work item |\n\n### Builds\n| Tool | Description |\n|------|-------------|\n| `list_builds` | List recent builds |\n| `get_build` | Get build details |\n| `get_build_logs` | Get build logs |\n| `list_build_definitions` | List build definitions |\n| `analyze_build_errors` | Extract errors from failed builds |\n\n### Work Items\n| Tool | Description |\n|------|-------------|\n| `query_work_items` | Search work items (WIQL or filters) |\n| `get_work_item` | Get work item details |\n| `list_work_item_types` | List available work item types |\n| `list_iterations` | List iterations/sprints in a project |\n| `list_areas` | List area paths in a project |\n\n### Releases\n| Tool | Description |\n|------|-------------|\n| `list_releases` | List releases |\n| `get_release` | Get release details |\n| `list_release_definitions` | List release definitions |\n| `get_release_logs` | Get deployment logs |\n\n### Pipelines\n| Tool | Description |\n|------|-------------|\n| `list_pipelines` | List YAML pipelines |\n| `get_pipeline_runs` | Get recent pipeline runs |\n| `get_pipeline_yaml` | Get pipeline YAML configuration |\n| `get_pipeline_variables` | Get pipeline variables |\n\n### Test Results\n| Tool | Description |\n|------|-------------|\n| `list_test_runs` | List test runs in a project |\n| `get_test_run` | Get test run details |\n| `get_test_results` | Get test results from a run |\n| `get_failed_tests` | Get failed tests from a run |\n| `get_test_runs_for_build` | Get test runs for a specific build |\n| `analyze_test_failures` | Analyze and group test failures |\n\n## Usage Examples\n\nOnce configured, you can ask your AI assistant questions like:\n\n- \"Show me the recent builds for project X\"\n- \"What's the status of PR #123?\"\n- \"List all bugs assigned to me\"\n- \"Show me the commits from last week\"\n- \"Why did build #456 fail?\"\n- \"What tests failed in build #789?\"\n- \"Compare branches Dev/9.1 and Dev/9.2\"\n- \"Search for 'IMediator' in the Controllers folder\"\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Watch mode\nnpm run dev\n```\n\n## Troubleshooting\n\n### Connection errors\n- Verify `AZURE_DEVOPS_URL` is correct and accessible\n- Check if your PAT has not expired\n- Ensure your network allows connection to the server\n\n### Permission errors\n- Verify PAT has required scopes\n- Check if you have access to the project/repository\n\n### \"Project is required\" errors\n- Set `AZURE_DEVOPS_PROJECT` environment variable, or\n- Pass `project` parameter in tool calls\n\n## License\n\nMIT\n","readmeFilename":"README.md"}