GitHub MCP Server Plus

Instructions

Implementation Reference

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

  The main handler function that executes the tool logic by making a GitHub API request to list commits in a repository.

  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)

  Zod input schema defining parameters for the list_commits tool: owner, repo, optional sha, page, perPage.

  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:119-122 (registration)

  Tool registration in the ListTools response, specifying 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:335-347 (registration)

  Dispatch logic in the CallToolRequest handler that parses arguments and invokes 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) }],
    };
  }