mcp-github

Instructions

Implementation Reference

• src/operations/projects.ts:129-151 (handler)

  The main handler function that executes the create_project tool logic by sending a POST request to GitHub API to create a project in the specified repository.

  export async function createProject(
    github_pat: string,
    owner: string,
    repo: string,
    name: string,
    body?: string
  ): Promise<z.infer<typeof ProjectSchema>> {
    const response = await githubRequest(
      github_pat,
      `https://api.github.com/repos/${owner}/${repo}/projects`,
      {
        method: "POST",
        body: {
          name,
          body,
        },
        headers: {
          "Accept": "application/vnd.github.inertia-preview+json",
        },
      }
    );
    return ProjectSchema.parse(response);
  }

• src/operations/projects.ts:61-66 (schema)

  Input schema definition for the create_project tool (public version without github_pat).

  export const CreateProjectSchema = z.object({
    owner: z.string().describe("Repository owner (username or organization)"),
    repo: z.string().describe("Repository name"),
    name: z.string().describe("The name of the project"),
    body: z.string().optional().describe("The description of the project"),
  });

• src/operations/projects.ts:68-70 (schema)

  Extended input schema including the required github_pat for internal parsing.

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

• src/operations/projects.ts:6-20 (schema)

  Output schema for parsing the GitHub project response.

  export const ProjectSchema = z.object({
    id: z.number(),
    node_id: z.string(),
    url: z.string(),
    html_url: z.string(),
    columns_url: z.string(),
    owner_url: z.string(),
    name: z.string(),
    body: z.string().nullable(),
    number: z.number(),
    state: z.string(),
    creator: GitHubIssueAssigneeSchema,
    created_at: z.string(),
    updated_at: z.string(),
  });

• src/index.ts:255-258 (registration)

  Tool registration in the listTools response, defining name, description, and input schema.

    name: "create_project",
    description: "Create a new project for a repository",
    inputSchema: zodToJsonSchema(projects.CreateProjectSchema),
  },

• src/index.ts:694-701 (handler)

  Dispatch handler in the main CallToolRequest handler that parses arguments and calls the projects.createProject function.

  case "create_project": {
    const args = projects._CreateProjectSchema.parse(params.arguments);
    const { github_pat, owner, repo, name, body } = args;
    const result = await projects.createProject(github_pat, owner, repo, name, body);
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }