Advent of Code MCP Server

Interaja com o site do Advent of Code. Requer um cookie de sessão para autenticação.

Documentação

Advent of Code MCP Server

Servidor MCP para interagir com o site do Advent of Code.

Este projeto é desenvolvido para fins educacionais. O servidor visa simplificar as interações com o site do Advent of Code e melhorar o fluxo de trabalho de resolução de quebra-cabeças.

No entanto, construir um aplicativo de autoenvio em torno das soluções provavelmente será a abordagem mais eficiente.

Ferramentas

GetAocProgress

  • Obtém a contagem de estrelas para um ano específico do Advent of Code
  • Parâmetros: year (int)
  • Retorna: Stars (int)

SubmitAnswer

  • Envia uma resposta para uma parte do dia do Advent of Code. Se a resposta anterior foi dada recentemente demais, aguarda até que possa ser enviada (com notificações de progresso).
  • Parâmetros: int year, int day, int part, string answer
  • Retorna: Correct / Incorrect / TooLow / TooHigh

GetInputResource

  • Recupera a entrada pessoal do quebra-cabeça
  • Parâmetros: int year, int day
  • Retorna: texto de entrada como um recurso incorporado

Recursos

aocinput://{year}/{day}

Modelo de recurso para a entrada pessoal do quebra-cabeça

Use este servidor MCP

Install with Docker in VS Code

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

Exemplos de prompts

> get aoc stats for 2024

> submit "42" for 2024/10/1

> get aoc input for 2024/10 and save it

> Get aoc input for 2024/10 and write it to a new file. Run aoc program for year 2024 day 10, pass 2024 and 10 as positional arguments and the created file path as --input-file argument. Read the answers from the output and submit them.