feat: Add support for retrieving file content from Azure DevOps branches

- Implement new `getFileFromBranch` method in Azure DevOps service
- Add `azure_devops_branch_file_content` tool for accessing file contents directly from branches
- Update README with new tool documentation
- Create `PullRequestFileContent` type for consistent file retrieval response
- Bump version to 1.0.3

Author: Maxim Titovich

README.md

@@ -217,6 +217,7 @@ registerTools(server, azureDevOpsService);
 | `azure_devops_work_item_attachments`| Get attachments for a work item     | `id` (number)                                                         |
 | `azure_devops_pull_request_changes` | Get detailed PR code changes        | `repositoryId` (string), `pullRequestId` (number), `project` (string) |
 | `azure_devops_pull_request_file_content` | Get content of large files in chunks | `repositoryId` (string), `pullRequestId` (number), `filePath` (string), `objectId` (string), `startPosition` (number), `length` (number), `project` (string) |
+| `azure_devops_branch_file_content` | Get file content directly from a branch | `repositoryId` (string), `branchName` (string), `filePath` (string), `startPosition` (number), `length` (number), `project` (string) |
 | `azure_devops_create_pr_comment`    | Create a comment on a pull request  | `repositoryId` (string), `pullRequestId` (number), `project` (string), `content` (string), and other optional parameters |
 
 ## Development

package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-azure-devops-mcp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "MCP Server for Cursor IDE-Azure DevOps Integration",
   "main": "build/index.js",
   "type": "module",

src/azure-devops-service.ts

@@ -541,6 +541,110 @@ class AzureDevOpsService {
     return binaryExtensions.includes(extension);
   }
 
+  /**
+   * Helper method to get a file's content from a specific branch
+   * This is useful for accessing files in pull requests when direct object ID access fails
+   */
+  async getFileFromBranch(
+    repositoryId: string,
+    filePath: string,
+    branchName: string,
+    startPosition = 0,
+    length = 100000,
+    project?: string
+  ): Promise<{ content: string; size: number; position: number; length: number; error?: string }> {
+    await this.initialize();
+
+    if (!this.gitClient) {
+      throw new Error('Git client not initialized');
+    }
+
+    // Use the provided project or fall back to the default project
+    const projectName = project || this.defaultProject;
+
+    if (!projectName) {
+      throw new Error('Project name is required');
+    }
+
+    try {
+      // Clean branch name (remove refs/heads/ if present)
+      const cleanBranchName = branchName.replace(/^refs\/heads\//, '');
+
+      // Get the branch reference to find the latest commit
+      const refs = await this.gitClient.getRefs(
+        repositoryId,
+        projectName,
+        `heads/${cleanBranchName}`
+      );
+
+      if (!refs || refs.length === 0) {
+        return {
+          content: '',
+          size: 0,
+          position: startPosition,
+          length: 0,
+          error: `Branch reference not found for ${cleanBranchName}`,
+        };
+      }
+
+      const commitId = refs[0].objectId;
+
+      // Get metadata about the file to know its full size
+      try {
+        const item = await this.gitClient.getItem(repositoryId, filePath, projectName, undefined, {
+          versionDescriptor: {
+            version: commitId,
+            versionOptions: 0, // Use exact version
+            versionType: 1, // Commit
+          },
+        });
+
+        const fileSize = item?.contentMetadata?.contentLength || 0;
+
+        // Get the content
+        const content = await this.gitClient.getItemText(
+          repositoryId,
+          filePath,
+          projectName,
+          undefined,
+          startPosition,
+          length,
+          {
+            versionDescriptor: {
+              version: commitId,
+              versionOptions: 0, // Use exact version
+              versionType: 1, // Commit
+            },
+          }
+        );
+
+        return {
+          content,
+          size: fileSize,
+          position: startPosition,
+          length: content.length,
+        };
+      } catch (error) {
+        return {
+          content: '',
+          size: 0,
+          position: startPosition,
+          length: 0,
+          error: `Failed to retrieve file from branch ${cleanBranchName}: ${(error as Error).message}`,
+        };
+      }
+    } catch (error) {
+      console.error(`Error accessing branch ${branchName}:`, error);
+      return {
+        content: '',
+        size: 0,
+        position: startPosition,
+        length: 0,
+        error: `Failed to access branch ${branchName}: ${(error as Error).message}`,
+      };
+    }
+  }
+
   /**
    * Create a comment on a pull request
    */

src/index.ts

@@ -316,6 +316,39 @@ server.tool(
   }
 );
 
+// New tool for getting file content directly from a branch
+server.tool(
+  'azure_devops_branch_file_content',
+  'Get content of a file directly from a branch (helps with PR file access)',
+  {
+    repositoryId: z.string().describe('Repository ID'),
+    branchName: z.string().describe('Branch name'),
+    filePath: z.string().describe('File path'),
+    startPosition: z.number().describe('Starting position in the file (bytes)').default(0),
+    length: z.number().describe('Length to read (bytes)').default(100000),
+    project: z.string().describe('Project name'),
+  },
+  async ({ repositoryId, branchName, filePath, startPosition, length, project }) => {
+    const result = await azureDevOpsService.getFileFromBranch(
+      repositoryId,
+      filePath,
+      branchName,
+      startPosition,
+      length,
+      project
+    );
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(result, null, 2),
+        },
+      ],
+    };
+  }
+);
+
 // New tool for creating pull request comments
 server.tool(
   'azure_devops_create_pr_comment',
@@ -393,6 +426,9 @@ async function main() {
     console.error(
       '- azure_devops_pull_request_file_content: Get content of a specific file in chunks (for large files)'
     );
+    console.error(
+      '- azure_devops_branch_file_content: Get content of a file directly from a branch'
+    );
     console.error('- azure_devops_create_pr_comment: Create a comment on a pull request');
   } catch (error) {
     console.error('Error starting server:', error);

src/sse-server.ts

@@ -287,6 +287,42 @@ app.get('/sse', async (req, res) => {
       }
     );
 
+    // New tool for getting file content directly from a branch
+    server.tool(
+      'azure_devops_branch_file_content',
+      'Get content of a file directly from a branch (helps with PR file access)',
+      {
+        repositoryId: z.string().describe('Repository ID'),
+        branchName: z.string().describe('Branch name'),
+        filePath: z.string().describe('File path'),
+        startPosition: z.number().describe('Starting position in the file (bytes)').default(0),
+        length: z.number().describe('Length to read (bytes)').default(100000),
+        project: z.string().describe('Project name'),
+      },
+      async (
+        { repositoryId, branchName, filePath, startPosition, length, project },
+        { signal }
+      ) => {
+        signal.throwIfAborted();
+        const result = await azureDevOpsService.getFileFromBranch(
+          repositoryId,
+          filePath,
+          branchName,
+          startPosition,
+          length,
+          project
+        );
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+    );
+
     // New tool for creating pull request comments
     server.tool(
       'azure_devops_create_pr_comment',

src/types.ts

@@ -178,3 +178,14 @@ export interface PullRequestCommentResponse {
   createdDate?: string;
   url?: string;
 }
+
+/**
+ * Response type for file content retrieval in pull requests
+ */
+export interface PullRequestFileContent {
+  content: string;
+  size: number;
+  position: number;
+  length: number;
+  error?: string;
+}