Advent of Code MCP Server

Advent of Code MCP Server

Servidor MCP para interactuar con el sitio web de Advent of Code.

Este proyecto se desarrolla con fines educativos. El servidor tiene como objetivo simplificar las interacciones con el sitio web de Advent of Code y mejorar el flujo de trabajo de resolución de acertijos.

Sin embargo, construir una aplicación de autoenvío alrededor de las soluciones probablemente sea el enfoque más eficiente.

Herramientas

GetAocProgress

• Obtiene el recuento de estrellas para un año específico de Advent of Code
• Parámetros: year (int)
• Devuelve: Stars (int)

SubmitAnswer

• Envía una respuesta para una parte de un día de Advent of Code. Si la respuesta anterior se ha dado demasiado recientemente, espera hasta que pueda enviarse (con notificaciones de progreso).
• Parámetros: int year, int day, int part, string answer
• Devuelve: Correct / Incorrect / TooLow / TooHigh

GetInputResource

• Recupera la entrada personal del acertijo
• Parámetros: int year, int day
• Devuelve: texto de entrada como recurso incrustado

Recursos

aocinput://{year}/{day}

Plantilla de recurso para la entrada personal del acertijo

Usa este servidor MCP

{
  "mcpServers": {
    "aoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SESSION_COOKIE",
        "ghcr.io/mazharenko/aoc-mcp"
      ],
      "env": {
        "SESSION_COOKIE": "<session>"
      }
    }
  }
}

Ejemplos de prompts

> obtener estadísticas de aoc para 2024

> enviar "42" para 2024/10/1

> obtener entrada de aoc para 2024/10 y guardarla

> Obtener entrada de aoc para 2024/10 y escribirla en un nuevo archivo. Ejecutar el programa aoc para el año 2024 día 10, pasar 2024 y 10 como argumentos posicionales y la ruta del archivo creado como argumento --input-file. Leer las respuestas de la salida y enviarlas.