MCP Azure DevOps Server

Instructions

Implementation Reference

• mcp_azure_devops/azure_devops_client.py:299-346 (handler)

  Core handler implementation that safely updates wiki pages with retry logic on version conflicts using ETag for optimistic concurrency.

  def update_wiki_page_safe(self, project, wiki_identifier, path, content, max_retries=3):
      """
      Safely updates a wiki page with automatic retry on version conflicts.
      """
      for attempt in range(max_retries):
          try:
              # Get the latest version of the page
              page = self.wiki_client.get_page(
                  project=project,
                  wiki_identifier=wiki_identifier,
                  path=path
              )
              
              # Try to get ETag from various possible locations
              etag = None
              if hasattr(page, 'eTag'):
                  etag = page.eTag
              elif hasattr(page, 'etag'):
                  etag = page.etag
              elif hasattr(page, 'e_tag'):
                  etag = page.e_tag
              elif hasattr(page, '_etag'):
                  etag = page._etag
              elif hasattr(page, 'page') and hasattr(page.page, 'eTag'):
                  etag = page.page.eTag
              elif hasattr(page, 'page') and hasattr(page.page, 'etag'):
                  etag = page.page.etag
              elif hasattr(page, 'page') and hasattr(page.page, 'e_tag'):
                  etag = page.page.e_tag
              
              parameters = {
                  "content": content
              }
              return self.wiki_client.create_or_update_page(
                  project=project,
                  wiki_identifier=wiki_identifier,
                  path=path,
                  parameters=parameters,
                  version=etag
              )
          except Exception as e:
              if "version" in str(e).lower() and attempt < max_retries - 1:
                  # Version conflict, retry with fresh version
                  continue
              else:
                  raise e
      
      raise Exception(f"Failed to update wiki page after {max_retries} attempts due to version conflicts")

• mcp_azure_devops/server.py:588-618 (schema)

  Tool schema definition including input parameters and validation for update_wiki_page_safe.

  types.Tool(
      name="update_wiki_page_safe",
      description="Safely updates a wiki page with automatic retry on version conflicts.",
      inputSchema={
          "type": "object",
          "properties": {
              "project": {
                  "type": "string", 
                  "description": "The name or ID of the project."
              },
              "wiki_identifier": {
                  "type": "string", 
                  "description": "The name or ID of the wiki."
              },
              "path": {
                  "type": "string", 
                  "description": "The path of the wiki page."
              },
              "content": {
                  "type": "string", 
                  "description": "The content of the wiki page."
              },
              "max_retries": {
                  "type": "integer", 
                  "description": "Maximum number of retry attempts (default: 3)."
              },
          },
          "required": ["project", "wiki_identifier", "path", "content"],
          "additionalProperties": False
      }
  ),

• mcp_azure_devops/server.py:1003-1010 (handler)

  Server-side dispatch handler that calls the client method and formats the response for the MCP protocol.

  elif name == "update_wiki_page_safe":
      page = self.client.update_wiki_page_safe(**arguments)
      return {
          "path": page.page.path,
          "url": page.page.url,
          "content": page.page.content,
          "message": "Wiki page updated successfully with safe retry mechanism."
      }

• mcp_azure_devops/azure_devops_client.py:348-361 (helper)

  Helper method that uses update_wiki_page_safe for upsert logic, falling back to create if not found.

  def create_or_update_wiki_page_smart(self, project, wiki_identifier, path, content):
      """
      Creates a new wiki page or updates existing one intelligently.
      """
      try:
          # Try to update first
          return self.update_wiki_page_safe(project, wiki_identifier, path, content)
      except Exception as e:
          if "not found" in str(e).lower() or "404" in str(e):
              # Page doesn't exist, create it
              return self.create_wiki_page(project, wiki_identifier, path, content)
          else:
              raise e