{"id":26937427,"url":"https://github.com/Tiberriver256/mcp-server-azure-devops","last_synced_at":"2025-04-02T13:15:27.630Z","repository":{"id":279880123,"uuid":"940300511","full_name":"Tiberriver256/mcp-server-azure-devops","owner":"Tiberriver256","description":"An MCP server for Azure DevOps","archived":false,"fork":false,"pushed_at":"2025-03-26T22:18:11.000Z","size":813,"stargazers_count":7,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T22:22:45.744Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Tiberriver256.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-28T00:05:42.000Z","updated_at":"2025-03-26T22:07:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"78bce7a9-e654-4470-b485-7b00810901d9","html_url":"https://github.com/Tiberriver256/mcp-server-azure-devops","commit_stats":null,"previous_names":["tiberriver256/azure-devops-mcp","tiberriver256/mcp-server-azure-devops"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tiberriver256%2Fmcp-server-azure-devops","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tiberriver256%2Fmcp-server-azure-devops/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tiberriver256%2Fmcp-server-azure-devops/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Tiberriver256%2Fmcp-server-azure-devops/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Tiberriver256","download_url":"https://codeload.github.com/Tiberriver256/mcp-server-azure-devops/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246819775,"owners_count":20839095,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-02T13:15:13.364Z","updated_at":"2025-04-02T13:15:27.620Z","avatar_url":"https://github.com/Tiberriver256.png","language":"TypeScript","readme":"# Azure DevOps MCP Server\n\nA Model Context Protocol (MCP) server implementation for Azure DevOps, allowing AI assistants to interact with Azure DevOps APIs through a standardized protocol.\n\n## Overview\n\nThis server implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) for Azure DevOps, enabling AI assistants like Claude to interact with Azure DevOps resources securely. The server acts as a bridge between AI models and Azure DevOps APIs, providing a standardized way to:\n\n- Access and manage projects, work items, repositories, and more\n- Create and update work items, branches, and pull requests\n- Execute common DevOps workflows through natural language\n- Safely authenticate and interact with Azure DevOps resources\n\n## Server Structure\n\nThe server is structured around the Model Context Protocol (MCP) for communicating with AI assistants. It provides tools for interacting with Azure DevOps resources including:\n\n- Projects\n- Work Items\n- Repositories\n- Pull Requests\n- Branches\n- Pipelines\n\n### Core Components\n\n- **AzureDevOpsServer**: Main server class that initializes the MCP server and registers tools\n- **Tool Handlers**: Modular functions for each Azure DevOps operation\n- **Configuration**: Environment-based configuration for organization URL, PAT, etc.\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js (v16+)\n- npm or yarn\n- Azure DevOps account with appropriate access\n- Authentication credentials (see [Authentication Guide](docs/authentication.md) for details):\n  - Personal Access Token (PAT), or\n  - Azure Identity credentials, or\n  - Azure CLI login\n\n### Running with NPX\n\n### Usage with Claude Desktop/Cursor AI\n\nTo integrate with Claude Desktop or Cursor AI, add one of the following configurations to your configuration file.\n\n\n#### Azure Identity Authentication\n\nBe sure you are logged in to Azure CLI with `az login` then add the following:\n\n```json\n{\n  \"mcpServers\": {\n    \"azureDevOps\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@tiberriver256/mcp-server-azure-devops\"],\n      \"env\": {\n        \"AZURE_DEVOPS_ORG_URL\": \"https://dev.azure.com/your-organization\",\n        \"AZURE_DEVOPS_AUTH_METHOD\": \"azure-identity\",\n        \"AZURE_DEVOPS_DEFAULT_PROJECT\": \"your-project-name\"\n      }\n    }\n  }\n}\n```\n\n\n#### Personal Access Token (PAT) Authentication\n\n```json\n{\n  \"mcpServers\": {\n    \"azureDevOps\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@tiberriver256/mcp-server-azure-devops\"],\n      \"env\": {\n        \"AZURE_DEVOPS_ORG_URL\": \"https://dev.azure.com/your-organization\",\n        \"AZURE_DEVOPS_AUTH_METHOD\": \"pat\",\n        \"AZURE_DEVOPS_PAT\": \"\u003cYOUR_PAT\u003e\",\n        \"AZURE_DEVOPS_DEFAULT_PROJECT\": \"your-project-name\"\n      }\n    }\n  }\n}\n```\n\nFor detailed configuration instructions and more authentication options, see the [Authentication Guide](docs/authentication.md).\n\n\n## Authentication Methods\n\nThis server supports multiple authentication methods for connecting to Azure DevOps APIs. For detailed setup instructions, configuration examples, and troubleshooting tips, see the [Authentication Guide](docs/authentication.md).\n\n### Supported Authentication Methods\n\n1. **Personal Access Token (PAT)** - Simple token-based authentication\n2. **Azure Identity (DefaultAzureCredential)** - Flexible authentication using the Azure Identity SDK\n3. **Azure CLI** - Authentication using your Azure CLI login\n\nExample configuration files for each authentication method are available in the [examples directory](docs/examples/).\n\n## Environment Variables\n\nFor a complete list of environment variables and their descriptions, see the [Authentication Guide](docs/authentication.md#configuration-reference).\n\nKey environment variables include:\n\n| Variable                       | Description                                                                        | Required           | Default            |\n| ------------------------------ | ---------------------------------------------------------------------------------- | ------------------ | ------------------ |\n| `AZURE_DEVOPS_AUTH_METHOD`     | Authentication method (`pat`, `azure-identity`, or `azure-cli`) - case-insensitive | No                 | `azure-identity`   |\n| `AZURE_DEVOPS_ORG`             | Azure DevOps organization name                                                     | No                 | Extracted from URL |\n| `AZURE_DEVOPS_ORG_URL`         | Full URL to your Azure DevOps organization                                         | Yes                | -                  |\n| `AZURE_DEVOPS_PAT`             | Personal Access Token (for PAT auth)                                               | Only with PAT auth | -                  |\n| `AZURE_DEVOPS_DEFAULT_PROJECT` | Default project if none specified                                                  | No                 | -                  |\n| `AZURE_DEVOPS_API_VERSION`     | API version to use                                                                 | No                 | Latest             |\n| `AZURE_AD_TENANT_ID`           | Azure AD tenant ID (for AAD auth)                                                  | Only with AAD auth | -                  |\n| `AZURE_AD_CLIENT_ID`           | Azure AD application ID (for AAD auth)                                             | Only with AAD auth | -                  |\n| `AZURE_AD_CLIENT_SECRET`       | Azure AD client secret (for AAD auth)                                              | Only with AAD auth | -                  |\n| `LOG_LEVEL`                    | Logging level (debug, info, warn, error)                                           | No                 | info               |\n\n## Troubleshooting Authentication\n\nFor detailed troubleshooting information for each authentication method, see the [Authentication Guide](docs/authentication.md#troubleshooting-authentication-issues).\n\nCommon issues include:\n\n- Invalid or expired credentials\n- Insufficient permissions\n- Network connectivity problems\n- Configuration errors\n\n## Authentication Implementation Details\n\nFor technical details about how authentication is implemented in the Azure DevOps MCP server, see the [Authentication Guide](docs/authentication.md) and the source code in the `src/auth` directory.\n\n## Available Tools\n\nThe Azure DevOps MCP server provides a variety of tools for interacting with Azure DevOps resources. For detailed documentation on each tool, please refer to the corresponding documentation.\n\n### Core Navigation Tools\n\n- `list_organizations`: List all accessible organizations\n- `list_projects`: List all accessible projects\n- `list_repositories`: List all repositories in a project\n\nFor comprehensive documentation on all core navigation tools, see the [Core Navigation Tools Guide](docs/tools/core-navigation.md).\n\n### Project Tools\n\n- `get_project`: Get details of a specific project\n\nFor project-specific tool documentation, see the [Projects Tools Guide](docs/tools/projects.md).\n\n### Repository Tools\n\n- `get_repository`: Get repository details\n\nFor repository-specific tool documentation, see the [Repositories Tools Guide](docs/tools/repositories.md).\n\n### Work Item Tools\n\n- `get_work_item`: Retrieve a work item by ID\n- `create_work_item`: Create a new work item\n- `update_work_item`: Update an existing work item\n- `list_work_items`: List work items in a project\n- `manage_work_item_link`: Add, remove, or update links between work items\n\n### Search Tools\n\n- `search_code`: Search for code across repositories in a project\n\nFor search-specific tool documentation, see the [Search Tools Guide](docs/tools/search.md).\n\n## Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.\n\n## License\n\nMIT\n","funding_links":[],"categories":["Developer Tools","Cloud \u0026 DevOps MCP Servers","Version Control","📚 Projects (1974 total)","MCP 服务器精选列表","🤖 AI/ML","Table of Contents","Cloud Infrastructure","サーバー実装","DevOps and CI/CD","🔄 CI/CD \u0026 Version Control","MCP Servers"],"sub_categories":["Version Control","MCP Servers","🔄 版本控制 (Git / GitHub / GitLab)","Cloud Platforms","🔄 Version Control","🔄 \u003ca name=\"version-control\"\u003e\u003c/a\u003eバージョン管理","Cloud \u0026 DevOps","☁️ Cloud Providers"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTiberriver256%2Fmcp-server-azure-devops","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTiberriver256%2Fmcp-server-azure-devops","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTiberriver256%2Fmcp-server-azure-devops/lists"}