GitHub MCP Server Plus

Instructions

Implementation Reference

• operations/files.ts:109-146 (handler)

  Main handler function that implements the core logic for creating or updating a file in a GitHub repository using the GitHub API. Handles SHA fetching if not provided, encodes content, and makes PUT request.

  export async function createOrUpdateFile(
    owner: string,
    repo: string,
    path: string,
    content: string,
    message: string,
    branch: string,
    sha?: string
  ) {
    const encodedContent = Buffer.from(content).toString("base64");
  
    let currentSha = sha;
    if (!currentSha) {
      try {
        const existingFile = await getFileContents(owner, repo, path, branch);
        if (!Array.isArray(existingFile)) {
          currentSha = existingFile.sha;
        }
      } catch (error) {
        console.error("Note: File does not exist in branch, will create new file");
      }
    }
  
    const url = `https://api.github.com/repos/${owner}/${repo}/contents/${path}`;
    const body = {
      message,
      content: encodedContent,
      branch,
      ...(currentSha ? { sha: currentSha } : {}),
    };
  
    const response = await githubRequest(url, {
      method: "PUT",
      body,
    });
  
    return GitHubCreateUpdateFileResponseSchema.parse(response);
  }

• operations/files.ts:24-32 (schema)

  Zod schema defining the input parameters for the create_or_update_file tool.

  export const CreateOrUpdateFileSchema = z.object({
    owner: z.string().describe("Repository owner (username or organization)"),
    repo: z.string().describe("Repository name"),
    path: z.string().describe("Path where to create/update the file"),
    content: z.string().describe("Content of the file"),
    message: z.string().describe("Commit message"),
    branch: z.string().describe("Branch to create/update the file in"),
    sha: z.string().optional().describe("SHA of the file being replaced (required when updating existing files)"),
  });

• index.ts:68-72 (registration)

  Registration of the create_or_update_file tool in the MCP server's tools list, including name, description, and input schema reference.

  {
    name: "create_or_update_file",
    description: "Create or update a single file in a GitHub repository",
    inputSchema: zodToJsonSchema(files.CreateOrUpdateFileSchema),
  },

• index.ts:223-237 (handler)

  Dispatcher handler in the MCP CallToolRequest that parses arguments using the schema and delegates to the main createOrUpdateFile function.

  case "create_or_update_file": {
    const args = files.CreateOrUpdateFileSchema.parse(request.params.arguments);
    const result = await files.createOrUpdateFile(
      args.owner,
      args.repo,
      args.path,
      args.content,
      args.message,
      args.branch,
      args.sha
    );
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }