mcp-github

Instructions

Implementation Reference

• src/operations/statuses.ts:81-92 (handler)

  The core handler function that fetches commit statuses from the GitHub API endpoint `/repos/{owner}/{repo}/commits/{ref}/statuses` and parses the response using Zod.
  export async function getCommitStatuses( github_pat: string, owner: string, repo: string, ref: string ): Promise<z.infer<typeof CommitStatusSchema>[]> { const response = await githubRequest( github_pat, `https://api.github.com/repos/${owner}/${repo}/commits/${ref}/statuses` ); return z.array(CommitStatusSchema).parse(response); }
• src/operations/statuses.ts:34-42 (schema)

  Zod input schemas: GetCommitStatusesSchema (public) and _GetCommitStatusesSchema (internal with github_pat) used for validation.
  export const GetCommitStatusesSchema = z.object({ owner: z.string().describe("Repository owner (username or organization)"), repo: z.string().describe("Repository name"), ref: z.string().describe("The ref (SHA, branch name, or tag name) to get statuses for") }); export const _GetCommitStatusesSchema = GetCommitStatusesSchema.extend({ github_pat: z.string().describe("GitHub Personal Access Token"), });
• src/index.ts:217-220 (registration)

  Tool registration in the listTools handler, defining name, description, and inputSchema.
  name: "get_commit_statuses", description: "Get statuses for a commit", inputSchema: zodToJsonSchema(statuses.GetCommitStatusesSchema), },
• src/index.ts:629-636 (registration)

  Dispatch handler in the CallToolRequest switch statement that validates arguments and invokes the getCommitStatuses function.
  case "get_commit_statuses": { const args = statuses._GetCommitStatusesSchema.parse(params.arguments); const { github_pat, owner, repo, ref } = args; const result = await statuses.getCommitStatuses(github_pat, owner, repo, ref); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }