gamecalendar-mcp

Servidor MCP para la base de datos de GameCalendar (Neon Postgres). Permite a Claude consultar —y opcionalmente modificar— los datos del sitio directamente, sin pasar por la web.

Seguridad: lectura libre, escritura opt-in

• Lectura: siempre disponible.
• Escritura: solo si defines GAMECALENDAR_MCP_WRITE=1. Sin esa variable, las tools de escritura ni se registran (Claude no puede llamarlas).
• delete_blog_post es destructiva y exige confirm=true explícito.
• update_game solo toca campos editables a mano (section, score, opencritic_score, early_access, trailer); el resto lo gestiona el sync de IGDB.

Tools

Tool	Modo	Qué hace
list_releases	lectura	Juegos por sección/plataforma
search_games	lectura	Busca juegos por nombre
get_game	lectura	Ficha completa (id o slug)
list_blog_posts	lectura	Posts (con o sin borradores)
get_blog_post	lectura	Post completo por slug
db_stats	lectura	Resumen de la DB
create_blog_post	escritura	Crea post (borrador por defecto)
update_blog_post	escritura	Edita campos de un post
set_blog_published	escritura	Publica / despublica
delete_blog_post	escritura	Borra (requiere confirm=true)
update_game	escritura	Edita campos seguros de un juego

Variables de entorno

Variable	Obligatoria	Descripción
DATABASE_URL	sí	Cadena de conexión Neon (la misma de gamecalendar)
GAMECALENDAR_MCP_WRITE	no	1 para habilitar escritura

Conectarlo a Claude Code

Con el CLI (recomendado), solo lectura:

claude mcp add gamecalendar \
  --env DATABASE_URL="postgres://...neon..." \
  -- node /home/zaswear/projects/packages/gamecalendar-mcp/index.js

Con escritura habilitada, añade el flag:

claude mcp add gamecalendar \
  --env DATABASE_URL="postgres://...neon..." \
  --env GAMECALENDAR_MCP_WRITE=1 \
  -- node /home/zaswear/projects/packages/gamecalendar-mcp/index.js

O a mano, en la config MCP (~/.claude.json o .mcp.json del proyecto):

{
  "mcpServers": {
    "gamecalendar": {
      "command": "node",
      "args": ["/home/zaswear/projects/packages/gamecalendar-mcp/index.js"],
      "env": {
        "DATABASE_URL": "postgres://...neon...",
        "GAMECALENDAR_MCP_WRITE": "1"
      }
    }
  }
}

No pongas la DATABASE_URL en ningún archivo commiteado. Pásala por la config MCP (que es local) o por el entorno.

Probar sin Claude

pnpm -C packages/gamecalendar-mcp smoke          # solo lectura
pnpm -C packages/gamecalendar-mcp smoke --write  # comprueba que registran las tools de escritura

El smoke lee DATABASE_URL del .env de gamecalendar.