GitHub MCP Server

Instructions

Implementation Reference

• operations/projects.ts:418-446 (handler)

  The core handler function that executes the move_card tool logic by making a POST request to GitHub's API to move the project card.

  export async function moveCard(cardId: number, position: string, columnId?: number) {
      try {
          const url = `https://api.github.com/projects/columns/cards/${cardId}/moves`;
  
          const payload: Record<string, any> = {
              position: position
          };
  
          if (columnId) {
              payload.column_id = columnId;
          }
  
          await githubRequest(url, {
              method: 'POST',
              body: payload,
              headers: {
                  'Accept': 'application/vnd.github.inertia-preview+json'
              }
          });
  
          return { success: true };
      } catch (error) {
          if (error instanceof GitHubError) {
              throw error;
          }
  
          throw new GitHubError(`Failed to move card: ${(error as Error).message}`, 500, { error: (error as Error).message });
      }
  }

• operations/projects.ts:82-86 (schema)

  Zod input schema for the move_card tool defining parameters: card_id, position, and optional column_id.

  export const MoveCardSchema = z.object({
      card_id: z.number().describe("The unique identifier of the card"),
      position: z.enum(["top", "bottom"]).or(z.string().regex(/^after:\d+$/)).describe("The position of the card (top, bottom, or after:<card_id>)"),
      column_id: z.number().optional().describe("The column ID to move the card to"),
  });

• index.ts:255-259 (registration)

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

  {
    name: "move_card",
    description: "Move a card to a different position or column",
    inputSchema: zodToJsonSchema(projects.MoveCardSchema),
  },

• index.ts:702-712 (handler)

  Dispatcher case in the central CallToolRequest handler that parses arguments and calls the moveCard function.

  case "move_card": {
    const args = projects.MoveCardSchema.parse(request.params.arguments);
    const result = await projects.moveCard(
      args.card_id,
      args.position,
      args.column_id
    );
    return {
      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
    };
  }