mcp-github

Instructions

Implementation Reference

• src/operations/repository.ts:64-79 (handler)

  The main handler function that performs the GitHub repository fork operation using the GitHub API.

  export async function forkRepository(
    github_pat: string,
    owner: string,
    repo: string,
    organization?: string
  ) {
    const url = organization
      ? `https://api.github.com/repos/${owner}/${repo}/forks?organization=${organization}`
      : `https://api.github.com/repos/${owner}/${repo}/forks`;
  
    const response = await githubRequest(github_pat, url, { method: "POST" });
    return GitHubRepositorySchema.extend({
      parent: GitHubRepositorySchema,
      source: GitHubRepositorySchema,
    }).parse(response);
  }

• src/operations/repository.ts:27-35 (schema)

  Zod schemas defining the input parameters for the fork_repository tool, including the public schema and internal schema with GitHub PAT.

  export const ForkRepositorySchema = z.object({
    owner: z.string().describe("Repository owner (username or organization)"),
    repo: z.string().describe("Repository name"),
    organization: z.string().optional().describe("Optional: organization to fork to (defaults to your personal account)"),
  });
  
  export const _ForkRepositorySchema = ForkRepositorySchema.extend({
    github_pat: z.string().describe("GitHub Personal Access Token"),
  });

• src/index.ts:113-117 (registration)

  Tool registration in the MCP server's listTools response, defining the name, description, and input schema.

  {
    name: "fork_repository",
    description: "Fork a GitHub repository to your account or specified organization",
    inputSchema: zodToJsonSchema(repository.ForkRepositorySchema),
  },

• src/index.ts:331-337 (registration)

  Dispatch logic in the MCP server's callTool handler that parses arguments and invokes the forkRepository function.

  case "fork_repository": {
    const args = repository._ForkRepositorySchema.parse(params.arguments);
    const fork = await repository.forkRepository(args.github_pat, args.owner, args.repo, args.organization);
    return {
      content: [{ type: "text", text: JSON.stringify(fork, null, 2) }],
    };
  }