GitHub MCP Server

Instructions

Implementation Reference

• operations/repository.ts:29-35 (handler)

  The main handler function that executes the tool logic by making a POST request to GitHub's /user/repos endpoint with the provided options and parsing the response.

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

• operations/repository.ts:6-11 (schema)

  Zod schema defining the input parameters for the create_repository tool.

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

• index.ts:80-84 (registration)

  Registration of the tool in the MCP server's listTools handler, including name, description, and input schema.

  {
    name: "create_repository",
    description: "Create a new GitHub repository in your account",
    inputSchema: zodToJsonSchema(repository.CreateRepositoryOptionsSchema),
  },

• index.ts:349-355 (handler)

  Dispatch handler in the CallToolRequestSchema that validates arguments and calls the createRepository function.

  case "create_repository": {
    const args = repository.CreateRepositoryOptionsSchema.parse(request.params.arguments);
    const result = await repository.createRepository(args);
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }