Azure DevOps MCP Server with PAT Authentication

Instructions

Implementation Reference

• src/tools/repos.ts:663-715 (handler)

  The handler function for the 'repo_create_pull_request_thread' tool. It constructs a CommentThreadContext based on provided parameters and uses the Azure DevOps Git API to create a new comment thread on the specified pull request.
  async ({ repositoryId, pullRequestId, content, project, filePath, status, rightFileStartLine, rightFileStartOffset, rightFileEndLine, rightFileEndOffset }) => { const connection = await connectionProvider(); const gitApi = await connection.getGitApi(); const threadContext: CommentThreadContext = { filePath: filePath }; if (rightFileStartLine !== undefined) { if (rightFileStartLine < 1) { throw new Error("rightFileStartLine must be greater than or equal to 1."); } threadContext.rightFileStart = { line: rightFileStartLine }; if (rightFileStartOffset !== undefined) { if (rightFileStartOffset < 1) { throw new Error("rightFileStartOffset must be greater than or equal to 1."); } threadContext.rightFileStart.offset = rightFileStartOffset; } } if (rightFileEndLine !== undefined) { if (rightFileStartLine === undefined) { throw new Error("rightFileEndLine must only be specified if rightFileStartLine is also specified."); } if (rightFileEndLine < 1) { throw new Error("rightFileEndLine must be greater than or equal to 1."); } threadContext.rightFileEnd = { line: rightFileEndLine }; if (rightFileEndOffset !== undefined) { if (rightFileEndOffset < 1) { throw new Error("rightFileEndOffset must be greater than or equal to 1."); } threadContext.rightFileEnd.offset = rightFileEndOffset; } } const thread = await gitApi.createThread( { comments: [{ content: content }], threadContext: threadContext, status: CommentThreadStatus[status as keyof typeof CommentThreadStatus] }, repositoryId, pullRequestId, project ); return { content: [{ type: "text", text: JSON.stringify(thread, null, 2) }], }; }
• src/tools/repos.ts:633-662 (schema)

  Zod schema defining the input parameters for the 'repo_create_pull_request_thread' tool, including repositoryId, pullRequestId, content, and optional positioning parameters.
  repositoryId: z.string().describe("The ID of the repository where the pull request is located."), pullRequestId: z.number().describe("The ID of the pull request where the comment thread exists."), content: z.string().describe("The content of the comment to be added."), project: z.string().optional().describe("Project ID or project name (optional)"), filePath: z.string().optional().describe("The path of the file where the comment thread will be created. (optional)"), status: z .enum(getEnumKeys(CommentThreadStatus) as [string, ...string[]]) .optional() .default(CommentThreadStatus[CommentThreadStatus.Active]) .describe("The status of the comment thread. Defaults to 'Active'."), rightFileStartLine: z.number().optional().describe("Position of first character of the thread's span in right file. The line number of a thread's position. Starts at 1. (optional)"), rightFileStartOffset: z .number() .optional() .describe( "Position of first character of the thread's span in right file. The line number of a thread's position. The character offset of a thread's position inside of a line. Starts at 1. Must only be set if rightFileStartLine is also specified. (optional)" ), rightFileEndLine: z .number() .optional() .describe( "Position of last character of the thread's span in right file. The line number of a thread's position. Starts at 1. Must only be set if rightFileStartLine is also specified. (optional)" ), rightFileEndOffset: z .number() .optional() .describe( "Position of last character of the thread's span in right file. The character offset of a thread's position inside of a line. Must only be set if rightFileEndLine is also specified. (optional)" ), },
• src/tools/repos.ts:629-716 (registration)

  The server.tool call that registers the 'repo_create_pull_request_thread' tool with its schema and handler.
  server.tool( REPO_TOOLS.create_pull_request_thread, "Creates a new comment thread on a pull request.", { repositoryId: z.string().describe("The ID of the repository where the pull request is located."), pullRequestId: z.number().describe("The ID of the pull request where the comment thread exists."), content: z.string().describe("The content of the comment to be added."), project: z.string().optional().describe("Project ID or project name (optional)"), filePath: z.string().optional().describe("The path of the file where the comment thread will be created. (optional)"), status: z .enum(getEnumKeys(CommentThreadStatus) as [string, ...string[]]) .optional() .default(CommentThreadStatus[CommentThreadStatus.Active]) .describe("The status of the comment thread. Defaults to 'Active'."), rightFileStartLine: z.number().optional().describe("Position of first character of the thread's span in right file. The line number of a thread's position. Starts at 1. (optional)"), rightFileStartOffset: z .number() .optional() .describe( "Position of first character of the thread's span in right file. The line number of a thread's position. The character offset of a thread's position inside of a line. Starts at 1. Must only be set if rightFileStartLine is also specified. (optional)" ), rightFileEndLine: z .number() .optional() .describe( "Position of last character of the thread's span in right file. The line number of a thread's position. Starts at 1. Must only be set if rightFileStartLine is also specified. (optional)" ), rightFileEndOffset: z .number() .optional() .describe( "Position of last character of the thread's span in right file. The character offset of a thread's position inside of a line. Must only be set if rightFileEndLine is also specified. (optional)" ), }, async ({ repositoryId, pullRequestId, content, project, filePath, status, rightFileStartLine, rightFileStartOffset, rightFileEndLine, rightFileEndOffset }) => { const connection = await connectionProvider(); const gitApi = await connection.getGitApi(); const threadContext: CommentThreadContext = { filePath: filePath }; if (rightFileStartLine !== undefined) { if (rightFileStartLine < 1) { throw new Error("rightFileStartLine must be greater than or equal to 1."); } threadContext.rightFileStart = { line: rightFileStartLine }; if (rightFileStartOffset !== undefined) { if (rightFileStartOffset < 1) { throw new Error("rightFileStartOffset must be greater than or equal to 1."); } threadContext.rightFileStart.offset = rightFileStartOffset; } } if (rightFileEndLine !== undefined) { if (rightFileStartLine === undefined) { throw new Error("rightFileEndLine must only be specified if rightFileStartLine is also specified."); } if (rightFileEndLine < 1) { throw new Error("rightFileEndLine must be greater than or equal to 1."); } threadContext.rightFileEnd = { line: rightFileEndLine }; if (rightFileEndOffset !== undefined) { if (rightFileEndOffset < 1) { throw new Error("rightFileEndOffset must be greater than or equal to 1."); } threadContext.rightFileEnd.offset = rightFileEndOffset; } } const thread = await gitApi.createThread( { comments: [{ content: content }], threadContext: threadContext, status: CommentThreadStatus[status as keyof typeof CommentThreadStatus] }, repositoryId, pullRequestId, project ); return { content: [{ type: "text", text: JSON.stringify(thread, null, 2) }], }; } );
• src/tools/repos.ts:25-44 (helper)

  Constant object mapping internal tool names to their string identifiers, used for registration.
  const REPO_TOOLS = { list_repos_by_project: "repo_list_repos_by_project", list_pull_requests_by_repo: "repo_list_pull_requests_by_repo", list_pull_requests_by_project: "repo_list_pull_requests_by_project", list_branches_by_repo: "repo_list_branches_by_repo", list_my_branches_by_repo: "repo_list_my_branches_by_repo", list_pull_request_threads: "repo_list_pull_request_threads", list_pull_request_thread_comments: "repo_list_pull_request_thread_comments", get_repo_by_name_or_id: "repo_get_repo_by_name_or_id", get_branch_by_name: "repo_get_branch_by_name", get_pull_request_by_id: "repo_get_pull_request_by_id", create_pull_request: "repo_create_pull_request", update_pull_request: "repo_update_pull_request", update_pull_request_reviewers: "repo_update_pull_request_reviewers", reply_to_comment: "repo_reply_to_comment", create_pull_request_thread: "repo_create_pull_request_thread", resolve_comment: "repo_resolve_comment", search_commits: "repo_search_commits", list_pull_requests_by_commits: "repo_list_pull_requests_by_commits", };