mcp-github

MIT License
OverviewInspectSchema Related Servers Reviews Score
src
operations
import { z } from "zod";
import { githubRequest } from "../common/utils.js";
import { GitHubRepositorySchema, GitHubSearchResponseSchema } from "../common/types.js";

// Schema definitions
export const CreateRepositoryOptionsSchema = z.object({
  name: z.string().describe("Repository name"),
  description: z.string().optional().describe("Repository description"),
  private: z.boolean().optional().describe("Whether the repository should be private"),
  autoInit: z.boolean().optional().describe("Initialize with README.md"),
});

export const _CreateRepositoryOptionsSchema = CreateRepositoryOptionsSchema.extend({
  github_pat: z.string().describe("GitHub Personal Access Token"),
});

export const SearchRepositoriesSchema = z.object({
  query: z.string().describe("Search query (see GitHub search syntax)"),
  page: z.number().optional().describe("Page number for pagination (default: 1)"),
  perPage: z.number().optional().describe("Number of results per page (default: 30, max: 100)"),
});

export const _SearchRepositoriesSchema = SearchRepositoriesSchema.extend({
  github_pat: z.string().describe("GitHub Personal Access Token"),
});

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"),
});

// Type exports
export type CreateRepositoryOptions = z.infer<typeof CreateRepositoryOptionsSchema>;

// Function implementations
export async function createRepository(github_pat: string, options: CreateRepositoryOptions) {
  const response = await githubRequest(github_pat, "https://api.github.com/user/repos", {
    method: "POST",
    body: options,
  });
  return GitHubRepositorySchema.parse(response);
}

export async function searchRepositories(
  github_pat: string,
  query: string,
  page: number = 1,
  perPage: number = 30
) {
  const url = new URL("https://api.github.com/search/repositories");
  url.searchParams.append("q", query);
  url.searchParams.append("page", page.toString());
  url.searchParams.append("per_page", perPage.toString());

  const response = await githubRequest(github_pat, url.toString());
  return GitHubSearchResponseSchema.parse(response);
}

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);
}