steam-mcp

Un servidor MCP para decidir qué juegos de Steam encajan con una persona concreta. Clasifica la tienda según lo que el jugador realmente acumula en horas, combinado con lo que dice que le apetece en ese momento.

Diez herramientas. recommend_games es la puerta de entrada; el resto existen para que una clasificación pueda ser interrogada en lugar de aceptarse sin más.

Cómo ejecutarlo

npm install && npm run build
claude mcp add -s user steam-mcp -e STEAM_ID=<your SteamID64> -- node /path/to/steam-mcp/dist/index.js

Entorno:

• STEAM_ID (opcional): jugador por defecto, como SteamID64. Las herramientas también aceptan un nombre de usuario o URL de perfil por llamada.

• STEAM_API_KEY (opcional): de https://steamcommunity.com/dev/apikey. Solo las rutas de biblioteca, juego reciente y resolución de nombre de usuario la necesitan. Todo lo demás, incluida la lista de deseos en un perfil público, funciona sin clave, así que el servidor es útil sin ninguna credencial. Simplemente no puede personalizar.

Una caché en disco vive en $XDG_CACHE_HOME/steam-mcp (por defecto ~/.cache). El endpoint appdetails de la tienda está limitado a unas 200 por cada cinco minutos por IP; el cliente espacia ese endpoint a 1,5 s, los demás mucho más rápido, y cachea agresivamente (detalles seis horas, etiquetas y datos de Deck una semana) para que una segunda recomendación en la misma sesión sea casi gratis. Cada herramienta que enriquece una lista trabaja con un plazo y reporta cuántos juegos omitió, así que una petición larga devuelve una respuesta parcial en lugar de agotar el tiempo en un proxy.

Related MCP server: Steam Review and Forum MCP

Cómo funciona la clasificación

src/taste.ts contiene todo el modelo.

Perfil. Las horas de cada juego jugado se atribuyen a sus etiquetas de la comunidad en proporción a su cuota de votos, así que las horas de un simulador militar van sobre todo a Military y Tactical y solo una pizca a Multiplayer. Tres correcciones se aplican encima:

• Las etiquetas se ponderan por rareza, derivada del orden de popularidad del propio diccionario de etiquetas de Steam (sin peticiones extra). Sin esto, cada perfil empieza con Action, Open World, Simulation, sea quien sea el jugador.

• Los juegos de un mismo estudio se agrupan antes de comprimir. Tres entradas de Arma son tres mediciones de un mismo gusto, no tres veces la evidencia.

• Las horas se transforman con raíz cuadrada. Un valor atípico sigue liderando, pero no escribe todo el perfil.

El juego de dos semanas, cuando hay clave disponible, cuenta una segunda vez además de las horas de toda la vida: una vez como historial, otra como lo que el jugador está disfrutando ahora.

Puntuación. Dos señales en la misma escala de 0..1, combinadas a partes iguales: fit, el coseno entre el vector de etiquetas del candidato y el perfil, relativo a lo mejor que cualquier juego podría hacer; y want, cuánta de la masa de etiquetas del candidato es lo que el jugador pidió. La recepción luego penaliza por debajo de la línea de «Mostly Positive» de Steam (70%) y nunca recompensa por encima, porque los candidatos ya llegan ordenados por reseñas y recompensarlos de nuevo contaría la popularidad dos veces. Cada entrada matchedOn reportada está en puntos de puntuación y dice si la biblioteca o la petición la ganó.

Orden. La lista final se reordena de forma codiciosa para variedad: un candidato pierde hasta el 40% de su puntuación por parecerse a algo ya elegido. Las puntuaciones se reportan sin tocar; solo cambia el orden, y la descripción de la herramienta lo dice.

Pruebas

npm test

Ambas suites se ejecutan contra la API en vivo, a propósito. test/smoke.mjs maneja el servidor compilado sobre MCP stdio real, que es el único lugar donde un esquema silenciosamente descartado o un endpoint de tienda cambiado se detecta. test/taste.ts ejecuta el modelo sobre test/fixtures/library.json, una biblioteca real de 45 juegos, y verifica el comportamiento de la clasificación en lugar de números exactos, ya que los votos de etiquetas varían. Configura STEAM_API_KEY para ejercitar también las herramientas con clave.

Despliegue con clave

Un servidor stdio de larga duración no puede obtener su clave de un broker de secretos por petición, así que el despliegue con clave vive donde una variable de entorno pueda inyectarse al inicio del proceso: una línea environment= de supervisord, una variable de Nomad, un EnvironmentFile de systemd. El servidor lee STEAM_API_KEY una vez al arrancar y nunca la escribe en ningún sitio.