GitHub MCP Server

Instructions

Implementation Reference

• operations/projects.ts:94-114 (handler)

  Core handler function that performs the POST request to GitHub API to create a new project in the specified repository.

  export async function createProject(owner: string, repo: string, name: string, body?: string) {
      try {
          const url = `https://api.github.com/repos/${owner}/${repo}/projects`;
  
          const response = await githubRequest(url, {
              method: 'POST',
              body: {
                  name,
                  body: body || '',
              }
          });
  
          return response;
      } catch (error) {
          if (error instanceof GitHubError) {
              throw error;
          }
  
          throw new GitHubError(`Failed to create project: ${(error as Error).message}`, 500, { error: (error as Error).message });
      }
  }

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

  Zod schema defining the input parameters for the create_project tool: owner, repo, name, and optional body.

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

• index.ts:200-204 (registration)

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

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

• index.ts:578-589 (handler)

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

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