GitHub MCP Server

Instructions

Implementation Reference

• operations/projectsV2.ts:300-344 (handler)

  The core handler function that performs the GraphQL mutation to add an item (issue or PR) to a ProjectV2.

  export async function addItemToProjectV2(projectId: string, contentId: string) {
    try {
      const query = `
        mutation($input: AddProjectV2ItemByIdInput!) {
          addProjectV2ItemById(input: $input) {
            item {
              id
              content {
                ... on Issue {
                  id
                  title
                  number
                }
                ... on PullRequest {
                  id
                  title
                  number
                }
              }
            }
          }
        }
      `;
  
      const variables = {
        input: {
          projectId,
          contentId
        }
      };
  
      const response = await graphqlRequest(query, variables);
  
      return response.data.addProjectV2ItemById.item;
    } catch (error) {
      if (error instanceof GitHubError) {
        throw error;
      }
  
      throw new GitHubError(
        `Failed to add item to project v2: ${(error as Error).message}`,
        500,
        { error: (error as Error).message }
      );
    }

• operations/projectsV2.ts:37-40 (schema)

  Zod schema defining the input parameters: projectId and contentId.

  export const AddItemToProjectV2Schema = z.object({
    projectId: z.string().describe("The node ID of the project"),
    contentId: z.string().describe("The node ID of the issue or pull request to add")
  });

• index.ts:290-294 (registration)

  Tool registration in the MCP server's listTools response, specifying name, description, and input schema.

  {
    name: "add_item_to_project_v2",
    description: "Add an issue or pull request to a GitHub project V2 using GraphQL API",
    inputSchema: zodToJsonSchema(projectsV2.AddItemToProjectV2Schema),
  },

• index.ts:781-790 (helper)

  Dispatcher case in the callTool handler that parses arguments and invokes the main handler function.

  case "add_item_to_project_v2": {
    const args = projectsV2.AddItemToProjectV2Schema.parse(request.params.arguments);
    const result = await projectsV2.addItemToProjectV2(
      args.projectId,
      args.contentId
    );
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }