L2 Calendar

Consulte os próximos lançamentos de servidores privados de Lineage 2 por crônica através da API pública do L2 Calendar. Liste e pesquise servidores, navegue pelo catálogo de crônicas e rótulos. Somente leitura, sem autenticação, respostas em JSON.

GitHub

Documentação

l2calendar-mcp

Servidor MCP para L2 Calendar — consulte as próximas aberturas de servidores privados de Lineage 2 por crônica diretamente de qualquer cliente MCP (Claude Desktop, Cursor, VS Code, Windsurf, Cline...).

Ele encapsula a API do L2 Calendar, pública, gratuita e habilitada para CORS, e a expõe como ferramentas MCP.

Ferramentas

FerramentaO que faz
list_serversLista servidores rastreados, ordenados por status VIP + data de abertura. Filtros: chronicle, only_upcoming, new_only, min_rate, max_rate, limit.
get_chroniclesLista todas as crônicas (slug + nome de exibição) para usar como filtro.
search_serversBusca de texto livre em nome, site, taxa, crônica, descrição e rótulos.
get_serverRegistro público completo de um servidor por nome exato (sem diferenciar maiúsculas de minúsculas).
list_labelsRótulos distintos em uso (PTS, Low rate, Craft...) com cores.

Todo resultado é JSON, pronto para o modelo raciocinar sobre ele.

Fonte de dados

Todos os dados vêm da API pública:

  • GET https://l2calendar.com/api/servers — até 50 servidores por chamada, com filtro opcional ?chronicle=<slug>.
  • GET https://l2calendar.com/api/chronicles — o catálogo de crônicas.

A API é somente leitura, não requer chave e envia Access-Control-Allow-Origin: *.

Campos retornados por servidor: name, website_url, rate, opening_date, opening_time, opening_datetime_utc, description, is_vip, vip_level, multiproff, multicraft, is_new, chronicle e labels.

Nota: a API pública retorna uma única página de até 50 servidores (VIP primeiro, depois abertura mais próxima). As ferramentas que filtram ou buscam operam nessa página pública. Aumente a precisão com o filtro chronicle.

Instalação

Remoto (HTTP) — sem instalação

Quando hospedado, aponte seu cliente para o endpoint HTTP transmitível:

{
  "mcpServers": {
    "l2calendar": {
      "type": "http",
      "url": "https://<your-host>/mcp"
    }
  }
}

Local (stdio) via npx

{
  "mcpServers": {
    "l2calendar": {
      "command": "npx",
      "args": ["-y", "l2calendar-mcp"]
    }
  }
}

Local (stdio) a partir do código-fonte

git clone https://github.com/Dreiev/l2calendar-mcp.git
cd l2calendar-mcp
npm install
npm run build

{
  "mcpServers": {
    "l2calendar": {
      "command": "node",
      "args": ["/absolute/path/to/l2calendar-mcp/dist/index.js"]
    }
  }
}

Execute o transporte HTTP

node dist/index.js --http            # http://127.0.0.1:8787/mcp
node dist/index.js --http --port 9000

GET /health retorna { "status": "ok" } para verificações de disponibilidade.

Configuração

VariávelPadrãoFinalidade
L2CALENDAR_API_URLhttps://l2calendar.comURL base da instância do L2 Calendar a ser consultada.

Exemplos de prompts

  • "Liste os servidores Interlude que abrirão em breve."
  • "Quais servidores Classic são novos esta semana?"
  • "Busque servidores High Five com taxa x1000."
  • "Mostre-me todas as crônicas que o L2 Calendar rastreia."
  • "Obtenha os detalhes do servidor chamado L2Hispano."

Desenvolvimento

npm install
npm run build      # tsc -> dist/
npm run dev        # run src/index.ts directly (Node >= 22)
npm run start:http # build output over HTTP

Sobre o L2 Calendar

O L2 Calendar é um calendário e rastreador multilíngue (EN/ES/PT/RU) de aberturas de servidores privados de Lineage 2 por crônica — l2calendar.com.

Licença

MIT © Dreiev