Aoc Mcp
What is Aoc Mcp
The Advent of Code MCP Server is an educational tool designed to facilitate interaction with the Advent of Code website, providing a streamlined workflow for solving puzzles and tracking progress.
Use cases
This server is useful for users looking to automate the process of retrieving their Advent of Code progress, such as checking the number of stars earned in a specific year, simplifying the submission of solutions, and enhancing the overall experience of participating in the coding challenges.
How to use
To use the MCP server, deploy it using Docker and configure it with your session cookie. The server supports a specific command that allows it to run in a container while leveraging environment variables for session management, making it ready for immediate use.
Key features
Key features include the ability to retrieve star counts for specified Advent of Code years, ease of deployment with Docker, and a practical setup for automating interactions with the Advent of Code website.
Where to use
The MCP server can be used in development environments, particularly where Docker is available, such as local machines or cloud-based development platforms. It’s also suitable for educational settings where users want to interact with coding challenges effectively.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Aoc Mcp
The Advent of Code MCP Server is an educational tool designed to facilitate interaction with the Advent of Code website, providing a streamlined workflow for solving puzzles and tracking progress.
Use cases
This server is useful for users looking to automate the process of retrieving their Advent of Code progress, such as checking the number of stars earned in a specific year, simplifying the submission of solutions, and enhancing the overall experience of participating in the coding challenges.
How to use
To use the MCP server, deploy it using Docker and configure it with your session cookie. The server supports a specific command that allows it to run in a container while leveraging environment variables for session management, making it ready for immediate use.
Key features
Key features include the ability to retrieve star counts for specified Advent of Code years, ease of deployment with Docker, and a practical setup for automating interactions with the Advent of Code website.
Where to use
The MCP server can be used in development environments, particularly where Docker is available, such as local machines or cloud-based development platforms. It’s also suitable for educational settings where users want to interact with coding challenges effectively.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Advent of Code MCP Server
MCP server to interact with the Advent of Code website.
This project is developed for educational purposes. The server aims to simplify interactions with the Advent of Code website and enhance the puzzle-solving workflow.
However, building a self-submitting app around solutions will likely be the most efficient approach.
Tools
GetAocProgress
- Gets star count for a specified Advent of Code year
- Parameters:
year(int) - Returns:
Stars(int)
Use this MCP Server
{
"mcpServers": {
"aoc": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SESSION_COOKIE",
"ghcr.io/mazharenko/aoc-mcp"
],
"env": {
"SESSION_COOKIE": "<session>"
}
}
}
}Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
