Crea y mantén packs de mods de Thunderstore buscando mods, resolviendo dependencias y exportando perfiles de r2modman.
También conocido como packwarden-dev/packwarden, @packwarden-dev/thunderstore-mcp
- Stars
- 0
- Herramientas
- 5
- Descargas, 30 días
- —
- Última versión
- 0.1.0
- Último commit
- 26 oct 2026
- Licencia
- MIT
¿Qué es PackWarden MCP?
Crea y mantén packs de mods de Thunderstore buscando mods, resolviendo dependencias y exportando perfiles de r2modman. Expone 5 herramientas, como list_communities, search_mods, resolve_dependencies.
Resumen generado a partir del README del proyecto
Acerca del MCP server de PackWarden
Packwarden permite a los desarrolladores que usan asistentes de IA crear y mantener packs de mods de Thunderstore para juegos como Lethal Company, Risk of Rain 2 o Valheim. Este MCP server se conecta a la API pública de Thunderstore para ayudar a los usuarios a encontrar mods, gestionar árboles de dependencias complejos y auditar listas de mods existentes en busca de problemas como versiones desactualizadas o archivos faltantes. Funciona localmente a través de Node.js para Claude Desktop y Cursor, o puede ejecutarse como un servicio remoto mediante un modo streamable HTTP.
Los usuarios interactúan con herramientas específicas como search_mods para encontrar contenido por autor o categoría, y resolve_dependencies para calcular un cierre completo de dependencias transitivas. El servidor también puede ejecutar check_pack_health para identificar conflictos o paquetes obsoletos. Una vez que el pack está listo, export_r2modman_profile genera un archivo .r2z para usar en r2modman o en el Thunderstore Mod Manager. El sistema utiliza un caché local para mejorar la velocidad, aunque las comunidades grandes como Lethal Company requieren una cantidad significativa de memoria y tiempo inicial para cargar.
Qué puedes hacer con él
- 1Resolver dependencias complejasCalcula cada paquete y versión necesaria para que un mod específico funcione.
- 2Auditar la salud de la lista de modsComprueba una lista de mods para encontrar versiones desactualizadas, dependencias faltantes o entradas duplicadas.
- 3Buscar contenido de la comunidadLocaliza mods dentro de una comunidad de juego específica usando palabras clave, autores o categorías.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar PackWarden MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar PackWarden MCP en Claude Code
$ claude mcp add packwarden -- npx -y @packwarden-dev/thunderstore-mcpInstalar PackWarden MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"packwarden": {
"command": "npx",
"args": [
"-y",
"@packwarden-dev/thunderstore-mcp"
]
}
}
}Instalar PackWarden MCP en VS Code
.vscode/mcp.json
{
"servers": {
"packwarden": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@packwarden-dev/thunderstore-mcp"
]
}
}
}Instalar PackWarden MCP en VS Code CLI
$ code --add-mcp '{"name":"packwarden","type":"stdio","command":"npx","args":["-y","@packwarden-dev/thunderstore-mcp"]}'Instalar PackWarden MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"packwarden": {
"command": "npx",
"args": [
"-y",
"@packwarden-dev/thunderstore-mcp"
]
}
}
}Instalar PackWarden MCP en Codex
$ codex mcp add packwarden -- npx -y @packwarden-dev/thunderstore-mcpInstalar PackWarden MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.packwarden] command = "npx" args = ["-y", "@packwarden-dev/thunderstore-mcp"]
Instalar PackWarden MCP en Gemini CLI
$ gemini mcp add -s user packwarden npx -- -y @packwarden-dev/thunderstore-mcpInstalar PackWarden MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"packwarden": {
"command": "npx",
"args": [
"-y",
"@packwarden-dev/thunderstore-mcp"
]
}
}
}Herramientas de PackWarden MCP 5
Detectado desde el READMElist_communitiessearch_modsresolve_dependenciescheck_pack_healthexport_r2modman_profile
| list_communities | — | |
| search_mods | — | |
| resolve_dependencies | — | |
| check_pack_health | — | |
| export_r2modman_profile | — |
Configuración
TEST_COMMUNITYTSMCP_EXPORT_DIR
| Nombre | Descripción | Tipo |
|---|---|---|
| TEST_COMMUNITY | — | |
| TSMCP_EXPORT_DIR | — |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHubPackWarden — Thunderstore Mod-Pack MCP Server (v0.1.0)
PackWarden is not affiliated with or endorsed by Thunderstore. "Thunderstore" is used only to describe compatibility. Mod data comes from the public Thunderstore API (https://thunderstore.io).

Live output: searching Lethal Company mods, resolving MoreCompany's dependencies, and exporting an r2modman .r2z profile.
An MCP server that helps AI assistants build and maintain Thunderstore mod packs (Lethal Company, Risk of Rain 2, Valheim, and every other Thunderstore community).
Tools
| Tool | What it does |
|---|---|
list_communities |
List Thunderstore game communities (identifier + name). |
search_mods |
Search a community by name/owner/description/category; sort by relevance, downloads, rating, updated. |
resolve_dependencies |
Full transitive dependency closure for one or more packages/versions; final install set, missing deps, multi-version pins, optional tree. |
check_pack_health |
Audit a mod list: not found, removed version, deprecated, outdated, missing deps, dependency version conflicts, duplicates, NSFW. |
export_r2modman_profile |
Write an .r2z profile (r2modman / Thunderstore Mod Manager "Import profile → From file"), optionally with deps and config files. Nothing is uploaded. |
Mods are referenced as Owner-Name (latest) or Owner-Name-1.2.3.
Install
Requires Node.js ≥ 18.17.
git clone <repo> thunderstore-mcp && cd thunderstore-mcp
npm install && npm run build
Claude Desktop
Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):
{
"mcpServers": {
"thunderstore": {
"command": "node",
"args": ["/absolute/path/to/thunderstore-mcp/dist/main.js"],
"env": { "TSMCP_EXPORT_DIR": "/absolute/path/for/profiles" }
}
}
}
Restart Claude Desktop.
Cursor
~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"thunderstore": {
"command": "node",
"args": ["/absolute/path/to/thunderstore-mcp/dist/main.js"]
}
}
}
Streamable HTTP (remote / self-hosted)
npm run start:http # http://127.0.0.1:3333/mcp
PORT=8080 HOST=0.0.0.0 node dist/main.js --http
Cursor: { "mcpServers": { "thunderstore": { "url": "http://127.0.0.1:3333/mcp" } } }.
The HTTP mode is stateless (POST-only, JSON responses) and has no auth. Put it behind a reverse proxy with TLS and auth before exposing it.
Configuration (env)
| Var | Default | Meaning |
|---|---|---|
TSMCP_CACHE_DIR |
~/.cache/thunderstore-mcp |
Slim package-index cache |
TSMCP_LIST_TTL_MS |
3600000 (1h) |
Package-list freshness |
TSMCP_MIN_INTERVAL_MS |
1000 |
Minimum gap between outbound requests |
TSMCP_EXPORT_DIR |
./exports |
Where .r2z files are written |
TSMCP_CONTACT |
support@packwarden.dev |
Contact put in the User-Agent. Override if you run your own copy. |
TSMCP_BRAND |
PackWarden |
Brand in server name/User-Agent |
TSMCP_BASE_URL |
https://thunderstore.io |
API base |
Be a good API citizen
- One full package list download per community per TTL, then conditional requests (
If-Modified-Since). Results are cached on disk as a slim index. - Outbound requests are serialized (concurrency 1) and spaced ≥1s apart. On 429/5xx the client backs off and honours
Retry-After. - Identifying User-Agent with a contact address.
- If the network fails, the server keeps serving stale cache.
Tests (live API)
npm test # default community: valheim
TEST_COMMUNITY=valheim npm test
Tests cover stdio and streamable HTTP end-to-end against the live Thunderstore API.
Limitations
- Large communities are heavy. The first load of Lethal Company is about 330 MB of JSON, takes about 14 s, and uses about 1.4 GB of RAM. After that, loads from cache take about 3 s.
- Resolution follows r2modman behaviour (highest requested version wins). It does not do semver range solving, because Thunderstore pins exact versions.
- No profile code sharing, which would need an upload to Thunderstore. Only file export is supported.
- Search is local keyword scoring, not Thunderstore's own search ranking.
Preguntas sobre PackWarden MCP
¿Cómo agrego PackWarden MCP a Claude Code?
Ejecuta claude mcp add packwarden -- npx -y @packwarden-dev/thunderstore-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego PackWarden MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona PackWarden MCP?
Expone 5 herramientas, incluidas list_communities, search_mods, resolve_dependencies, check_pack_health, export_r2modman_profile.
¿Qué juegos soporta PackWarden?
Soporta cualquier comunidad de Thunderstore, incluyendo Lethal Company, Risk of Rain 2 y Valheim.
¿Cómo exporto mi lista de mods?
El servidor puede generar un perfil .r2z que se puede importar en r2modman o en el Thunderstore Mod Manager.
¿Cuáles son los requisitos de hardware para comunidades grandes?
Cargar comunidades grandes como Lethal Company puede requerir aproximadamente 1.4 GB de RAM y tardar unos 14 segundos en la primera carga.