{"_id":"@bugzy-ai/azure-devops-mcp-server","name":"@bugzy-ai/azure-devops-mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bugzy-ai/azure-devops-mcp-server","version":"0.1.0","description":"MCP server for Azure DevOps Work Item Tracking integration","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"bin":{"azure-devops-mcp-server":"dist/index.js"},"scripts":{"build":"tsc --project tsconfig.build.json","build:watch":"tsc --project tsconfig.build.json --watch","clean":"shx rm -rf dist","dev":"npx @modelcontextprotocol/inspector dist/index.js","prepublishOnly":"npm run clean && npm run build","start":"node dist/index.js"},"keywords":["mcp","azure-devops","work-items","model-context-protocol","ai","claude"],"author":{"name":"Bugzy AI"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/bugzy-ai/azure-devops-mcp-server.git"},"homepage":"https://github.com/bugzy-ai/azure-devops-mcp-server#readme","bugs":{"url":"https://github.com/bugzy-ai/azure-devops-mcp-server/issues"},"engines":{"node":">=20.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","dotenv":"^16.4.7","zod":"^3.22.4","zod-to-json-schema":"^3.22.4"},"devDependencies":{"@types/node":"^20.10.3","shx":"^0.3.4","typescript":"^5.3.2"},"_id":"@bugzy-ai/azure-devops-mcp-server@0.1.0","_nodeVersion":"24.11.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-VukHGGgZpj0bYHjsMbLbJzq+zLP4jhfOc64nFk/7QskAWm612IEX5Y2D8kq9P6dLSzlhAI2DobQKUWrleVvRag==","shasum":"d131ad898a607c980775d90191fc3b751637739a","tarball":"https://registry.npmjs.org/@bugzy-ai/azure-devops-mcp-server/-/azure-devops-mcp-server-0.1.0.tgz","fileCount":22,"unpackedSize":96580,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCtykPpgqTZSC20cWK8A7tCWyAS+1Dwrfdnn/OqDZ82wwIgaysl/SAXYe65XY3MFhooeGKkQkLxgnBYe9RW/NtNf7w="}]},"_npmUser":{"name":"dimitar-panayotov","email":"dimitar2306@gmail.com"},"directories":{},"maintainers":[{"name":"mslavov","email":"milko.slavov@gmail.com"},{"name":"dimitar-panayotov","email":"dimitar2306@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/azure-devops-mcp-server_0.1.0_1768817803658_0.5636962623193567"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-19T10:16:43.519Z","0.1.0":"2026-01-19T10:16:43.799Z","modified":"2026-01-19T10:16:43.990Z"},"maintainers":[{"name":"mslavov","email":"milko.slavov@gmail.com"},{"name":"dimitar-panayotov","email":"dimitar2306@gmail.com"}],"description":"MCP server for Azure DevOps Work Item Tracking integration","homepage":"https://github.com/bugzy-ai/azure-devops-mcp-server#readme","keywords":["mcp","azure-devops","work-items","model-context-protocol","ai","claude"],"repository":{"type":"git","url":"git+https://github.com/bugzy-ai/azure-devops-mcp-server.git"},"author":{"name":"Bugzy AI"},"bugs":{"url":"https://github.com/bugzy-ai/azure-devops-mcp-server/issues"},"license":"MIT","readme":"# Azure DevOps MCP Server\r\n\r\nMCP (Model Context Protocol) server for Azure DevOps Work Item Tracking integration. Enables AI assistants like Claude to search, create, update, and manage work items in Azure DevOps.\r\n\r\n## Features\r\n\r\n- **Search Work Items**: Query using WIQL (Work Item Query Language)\r\n- **Get Work Item**: Retrieve detailed work item information by ID\r\n- **Create Work Item**: Create Bugs, Tasks, User Stories, Features, etc.\r\n- **Update Work Item**: Modify fields, change state, update assignments\r\n- **Add Comments**: Add discussion comments to work items\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @bugzy-ai/azure-devops-mcp-server\r\n```\r\n\r\nOr run directly with npx:\r\n\r\n```bash\r\nnpx @bugzy-ai/azure-devops-mcp-server\r\n```\r\n\r\n## Configuration\r\n\r\n### Environment Variables\r\n\r\n| Variable | Required | Description |\r\n|----------|----------|-------------|\r\n| `AZURE_DEVOPS_ORG_URL` | Yes | Organization URL (e.g., `https://dev.azure.com/myorg`) |\r\n| `AZURE_DEVOPS_PAT` | Yes | Personal Access Token |\r\n| `AZURE_DEVOPS_MCP_DEBUG` | No | Enable debug logging to `.azure-devops-mcp/mcp.log` |\r\n\r\n> **Note:** Project name is specified per-request, not via environment variable. The AI agent discovers the project from context (e.g., `.bugzy/runtime/project-context.md`) or uses `azuredevops_list_projects` to find available projects.\r\n\r\n### Creating a Personal Access Token (PAT)\r\n\r\n1. Go to Azure DevOps → User Settings → Personal Access Tokens\r\n2. Click \"New Token\"\r\n3. Set the required scopes:\r\n   - `vso.work` - Read work items\r\n   - `vso.work_write` - Create and update work items\r\n4. Copy the token and set it as `AZURE_DEVOPS_PAT`\r\n\r\n### MCP Configuration\r\n\r\nAdd to your MCP configuration file (e.g., `claude_desktop_config.json`):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"azure-devops\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@bugzy-ai/azure-devops-mcp-server\"],\r\n      \"env\": {\r\n        \"AZURE_DEVOPS_ORG_URL\": \"https://dev.azure.com/your-org\",\r\n        \"AZURE_DEVOPS_PAT\": \"your-pat-token\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Tools\r\n\r\n### azuredevops_list_projects\r\n\r\nList all projects in the Azure DevOps organization. Use this to discover available projects.\r\n\r\n```typescript\r\n{\r\n  top?: number,   // Max projects to return (default: 100, max: 100)\r\n  skip?: number   // Number to skip for pagination (default: 0)\r\n}\r\n```\r\n\r\n### azuredevops_search_work_items\r\n\r\nSearch for work items using WIQL queries.\r\n\r\n```typescript\r\n{\r\n  project: string,     // Azure DevOps project name (required)\r\n  wiql: string,        // WIQL query\r\n  maxResults?: number  // Max results (default: 50, max: 200)\r\n}\r\n```\r\n\r\n**Example WIQL queries:**\r\n\r\n```sql\r\n-- Find open bugs\r\nSELECT [System.Id], [System.Title], [System.State]\r\nFROM WorkItems\r\nWHERE [System.WorkItemType] = 'Bug'\r\n  AND [System.State] <> 'Closed'\r\nORDER BY [System.CreatedDate] DESC\r\n\r\n-- Find work items assigned to me\r\nSELECT [System.Id], [System.Title]\r\nFROM WorkItems\r\nWHERE [System.AssignedTo] = @Me\r\n  AND [System.State] = 'Active'\r\n\r\n-- Find recent items in a specific area\r\nSELECT [System.Id], [System.Title], [System.WorkItemType]\r\nFROM WorkItems\r\nWHERE [System.AreaPath] UNDER 'Project\\Team'\r\n  AND [System.CreatedDate] >= @Today - 7\r\n```\r\n\r\n### azuredevops_get_work_item\r\n\r\nGet detailed information about a work item.\r\n\r\n```typescript\r\n{\r\n  project: string,      // Azure DevOps project name (required)\r\n  id: number,           // Work item ID\r\n  fields?: string[],    // Specific fields to retrieve\r\n  expand?: \"None\" | \"Relations\" | \"Fields\" | \"Links\" | \"All\"\r\n}\r\n```\r\n\r\n### azuredevops_create_work_item\r\n\r\nCreate a new work item.\r\n\r\n```typescript\r\n{\r\n  project: string,       // Azure DevOps project name (required)\r\n  type: string,          // \"Bug\", \"Task\", \"User Story\", etc.\r\n  title: string,         // Work item title\r\n  description?: string,  // Description (HTML supported)\r\n  areaPath?: string,     // Area path\r\n  iterationPath?: string,// Iteration/sprint path\r\n  assignedTo?: string,   // User email or display name\r\n  priority?: number,     // 1-4 (1=Critical, 4=Low)\r\n  severity?: string,     // For bugs: \"1 - Critical\", \"2 - High\", etc.\r\n  tags?: string,         // Semicolon-separated tags\r\n  parentId?: number      // Parent work item ID\r\n}\r\n```\r\n\r\n### azuredevops_update_work_item\r\n\r\nUpdate an existing work item using JSON Patch operations.\r\n\r\n```typescript\r\n{\r\n  project: string,  // Azure DevOps project name (required)\r\n  id: number,\r\n  operations: Array<{\r\n    op: \"add\" | \"remove\" | \"replace\",\r\n    path: string,   // e.g., \"/fields/System.State\"\r\n    value?: any\r\n  }>\r\n}\r\n```\r\n\r\n**Example - Change state to Active:**\r\n\r\n```json\r\n{\r\n  \"id\": 123,\r\n  \"operations\": [\r\n    { \"op\": \"replace\", \"path\": \"/fields/System.State\", \"value\": \"Active\" }\r\n  ]\r\n}\r\n```\r\n\r\n### azuredevops_add_comment\r\n\r\nAdd a comment to a work item.\r\n\r\n```typescript\r\n{\r\n  project: string,  // Azure DevOps project name (required)\r\n  id: number,       // Work item ID\r\n  text: string      // Comment text (HTML supported)\r\n}\r\n```\r\n\r\n## Development\r\n\r\n```bash\r\n# Install dependencies\r\nnpm install\r\n\r\n# Build\r\nnpm run build\r\n\r\n# Run with MCP Inspector (for testing)\r\nnpm run dev\r\n\r\n# Watch mode\r\nnpm run build:watch\r\n```\r\n\r\n## Debugging\r\n\r\nEnable debug logging by setting `AZURE_DEVOPS_MCP_DEBUG=true`. Logs are written to `.azure-devops-mcp/mcp.log`.\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md","_rev":"1-288aabf71b3d18b10851453a3cbb13a8"}