GitHub MCP Server

Instructions

Implementation Reference

• operations/commits.ts:12-26 (handler)

  The core handler function that executes the logic to fetch commits from the GitHub API for the 'list_commits' tool.

  export async function listCommits(
    owner: string,
    repo: string,
    page?: number,
    perPage?: number,
    sha?: string
  ) {
    return githubRequest(
      buildUrl(`https://api.github.com/repos/${owner}/${repo}/commits`, {
        page: page?.toString(),
        per_page: perPage?.toString(),
        sha
      })
    );
  }

• operations/commits.ts:4-10 (schema)

  Input schema for validating arguments to the 'list_commits' tool.

  export const ListCommitsSchema = z.object({
    owner: z.string(),
    repo: z.string(),
    sha: z.string().optional(),
    page: z.number().optional(),
    perPage: z.number().optional()
  });

• index.ts:115-119 (registration)

  Tool registration in the MCP server's list of tools, including name, description, and input schema.

  {
    name: "list_commits",
    description: "Get list of commits of a branch in a GitHub repository",
    inputSchema: zodToJsonSchema(commits.ListCommitsSchema)
  },

• index.ts:468-480 (handler)

  Dispatch handler in the main CallToolRequestSchema that parses input and calls the listCommits function.

  case "list_commits": {
    const args = commits.ListCommitsSchema.parse(request.params.arguments);
    const results = await commits.listCommits(
      args.owner,
      args.repo,
      args.page,
      args.perPage,
      args.sha
    );
    return {
      content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
    };
  }

• common/types.ts:113-130 (schema)

  Output schema defining the structure of the commits list returned by the GitHub API.

  export const GitHubListCommitsSchema = z.array(z.object({
    sha: z.string(),
    node_id: z.string(),
    commit: z.object({
      author: GitHubAuthorSchema,
      committer: GitHubAuthorSchema,
      message: z.string(),
      tree: z.object({
        sha: z.string(),
        url: z.string()
      }),
      url: z.string(),
      comment_count: z.number(),
    }),
    url: z.string(),
    html_url: z.string(),
    comments_url: z.string()
  }));