GitHub See MCP Server

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; import { z } from 'zod'; import PullRequest from "#features/pullRequests/pullRequest.service"; export function registerPullRequestTools(server: McpServer, pullRequestInstance: PullRequest) { server.registerTool( 'get_pull_request', { description: 'Get details of a specific pull request', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.getPullRequest(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'list_pull_requests', { description: 'List and filter repository pull requests', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), state: z.string().optional().describe('State of the pull request (open, closed, all)'), sort: z.string().optional().describe('Sort field (created, updated, popularity, long-running)'), direction: z.enum(['asc', 'desc']).optional().describe('Sort direction (asc or desc)'), perPage: z.number().optional().describe('Number of results per page'), page: z.number().optional().describe('Page number to retrieve'), fields: z.array(z.string()).optional().describe('Fields to return (string[], optional)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.getListPullRequests(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'merge_pull_request', { description: 'Merge a pull request', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), commitMessage: z.string().optional().describe('Commit message (string, optional)'), commit_title: z.string().optional().describe('Commit title (string, optional)'), merge_method: z.enum(['merge', 'squash', 'rebase']).optional().describe("Merge method ('merge', 'squash', 'rebase') (string, optional)"), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.mergePullRequest(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'get_pull_request_files', { description: 'Get the list of files changed in a pull request', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.getPullRequestFiles(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'get_pull_request_status', { description: 'Get the combined status of all status checks for a pull request', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.getPullRequestStatus(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'update_pull_request_branch', { description: 'Update a pull request branch with the latest changes from the base branch', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), expectedHeadSha: z.string().optional().describe("The expected SHA of the pull request's HEAD ref (string, optional)"), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.updatePullRequestBranch(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'get_pull_request_comments', { description: 'Get the review comments on a pull request', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.getPullRequestComments(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'get_pull_request_reviews', { description: 'Get the reviews on a pull request', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.getPullRequestReviews(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'create_pull_request_review', { description: 'Create a review on a pull request review', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), body: z.string().optional().describe('Review body (string, optional)'), event: z.enum(['approve', 'request_changes', 'comment']).optional().describe("Review event ('approve', 'request_changes', 'comment') (string, optional)"), commitId: z.string().optional().describe('SHA of the commit to review (string, optional)'), comments: z.array(z.string()).optional().describe('Array of comment objects (array, optional)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.createPullRequestReview(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'create_pull_request', { description: 'Create a new pull request', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), title: z.string().describe('Pull request title (string, required)'), head: z.string().describe('The name of the branch where your changes are implemented (string, required)'), base: z.string().describe('The name of the branch you want your changes pulled into (string, required)'), body: z.string().optional().describe('Pull request body (string, optional)'), draft: z.boolean().optional().describe('Indicates if this is a draft pull request (boolean, optional)'), maintainer_can_modify: z.boolean().optional().describe('Indicates if the pull request can be modified by the maintainer (boolean, optional)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.createPullRequest(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'add_pull_request_review_comment', { description: 'Add a review comment to a pull request or reply to an existing comment', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), body: z.string().describe('Comment body (string, required)'), path: z.string().describe('Path to the file (string, required)'), commit_id: z.string().optional().describe('SHA of the commit to comment on (string, optional)'), in_reply_to: z.number().optional().describe('ID of the comment to reply to (number, optional)'), subject_type: z.string().optional().describe('Type of the subject (string, optional)'), line: z.number().optional().describe('Line number in the file (number, optional)'), side: z.string().optional().describe('Side of the file (string, optional)'), start_line: z.number().optional().describe('Starting line number (number, optional)'), start_side: z.string().optional().describe('Starting side of the file (string, optional)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.addPullRequestReviewComment(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); server.registerTool( 'update_pull_request', { description: 'Update an existing pull request in a GitHub repository', inputSchema: { owner: z.string().describe('Repository owner (string, required)'), repo: z.string().describe('Repository name (string, required)'), pullNumber: z.number().describe('Pull request number (number, required)'), title: z.string().optional().describe('Pull request title (string, optional)'), body: z.string().optional().describe('Pull request body (string, optional)'), state: z.enum(['open', 'closed']).optional().describe("State of the pull request ('open', 'closed') (string, optional)"), base: z.string().optional().describe('New base branch name (string, optional)'), maintainer_can_modify: z.boolean().optional().describe('Indicates if the pull request can be modified by the maintainer (boolean, optional)'), }, }, async (args, req: any) => { try { let info = await pullRequestInstance.updatePullRequest(args, req.requestInfo.headers.github_token); return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] }; } catch (error: any) { return { content: [{ type: 'text', text: `Error : ${error.message}` }], isError: true }; } } ); }