GitHub MCP Server

Instructions

Implementation Reference

• operations/projects.ts:305-324 (handler)

  The core handler function that executes the tool logic by sending a DELETE request to the GitHub API to delete the specified project column.

  export async function deleteProjectColumn(columnId: number) {
      try {
          const url = `https://api.github.com/projects/columns/${columnId}`;
  
          await githubRequest(url, {
              method: 'DELETE',
              headers: {
                  'Accept': 'application/vnd.github.inertia-preview+json'
              }
          });
  
          return { success: true };
      } catch (error) {
          if (error instanceof GitHubError) {
              throw error;
          }
  
          throw new GitHubError(`Failed to delete project column: ${(error as Error).message}`, 500, { error: (error as Error).message });
      }
  }

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

  Zod schema for input validation of the delete_project_column tool, requiring the column_id.

  export const DeleteProjectColumnSchema = z.object({
      column_id: z.number().describe("The unique identifier of the column"),
  });

• index.ts:240-244 (registration)

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

  {
    name: "delete_project_column",
    description: "Delete a project column",
    inputSchema: zodToJsonSchema(projects.DeleteProjectColumnSchema),
  },

• index.ts:666-672 (handler)

  Server-side handler in the CallToolRequest that parses input, invokes the deleteProjectColumn function, and returns the formatted response.

  case "delete_project_column": {
    const args = projects.DeleteProjectColumnSchema.parse(request.params.arguments);
    const result = await projects.deleteProjectColumn(args.column_id);
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }