English Français العربية

io.github.packwarden-dev/packwarden

Registre officiel Recherche et web

Thunderstore mod search, dependency checks and r2modman export. Not affiliated with Thunderstore.

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @packwarden-dev/thunderstore-mcp
Claude Code 
claude mcp add packwarden -- npx -y @packwarden-dev/thunderstore-mcp@0.1.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "packwarden": {
            "command": "npx",
            "args": [
                "-y",
                "@packwarden-dev/thunderstore-mcp@0.1.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. PackWarden — Thunderstore Mod-Pack MCP Server (v0.1.0)
  2. Tools
  3. Install
  4. Configuration (env)
  5. Be a good API citizen
  6. Tests (live API)
  7. Limitations

PackWarden — 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).

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

ToolWhat it does
list_communitiesList Thunderstore game communities (identifier + name).
search_modsSearch a community by name/owner/description/category; sort by relevance, downloads, rating, updated.
resolve_dependenciesFull transitive dependency closure for one or more packages/versions; final install set, missing deps, multi-version pins, optional tree.
check_pack_healthAudit a mod list: not found, removed version, deprecated, outdated, missing deps, dependency version conflicts, duplicates, NSFW.
export_r2modman_profileWrite 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)

VarDefaultMeaning
TSMCP_CACHE_DIR~/.cache/thunderstore-mcpSlim package-index cache
TSMCP_LIST_TTL_MS3600000 (1h)Package-list freshness
TSMCP_MIN_INTERVAL_MS1000Minimum gap between outbound requests
TSMCP_EXPORT_DIR./exportsWhere .r2z files are written
TSMCP_CONTACTsupport@packwarden.devContact put in the User-Agent. Override if you run your own copy.
TSMCP_BRANDPackWardenBrand in server name/User-Agent
TSMCP_BASE_URLhttps://thunderstore.ioAPI 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.

Questions fréquentes

Qu'est-ce que io.github.packwarden-dev/packwarden ?

Thunderstore mod search, dependency checks and r2modman export. Not affiliated with Thunderstore.

Comment installer io.github.packwarden-dev/packwarden ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add packwarden -- npx -y @packwarden-dev/thunderstore-mcp@0.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.packwarden-dev/packwarden ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.packwarden-dev/packwarden est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.packwarden-dev/packwarden ?

Il est publié par packwarden-dev. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.