Erstelle und verwalte Thunderstore Mod-Packs, indem du Mods suchst, Abhängigkeiten auflöst und r2modman-Profile exportierst.
Auch bekannt als packwarden-dev/packwarden, @packwarden-dev/thunderstore-mcp
- Stars
- 0
- Tools
- 5
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.0
- Letzter Commit
- 26. Okt. 2026
- Lizenz
- MIT
Was ist PackWarden MCP?
Erstelle und verwalte Thunderstore Mod-Packs, indem du Mods suchst, Abhängigkeiten auflöst und r2modman-Profile exportierst. Er stellt 5 Tools bereit, etwa list_communities, search_mods, resolve_dependencies.
Zusammenfassung generiert aus dem README des Projekts
Über PackWarden MCP server
Das Erstellen und Verwalten von Thunderstore Mod-Packs für Spiele wie Lethal Company, Risk of Rain 2 oder Valheim ist das, was Packwarden für Entwickler mit KI-Assistenten ermöglicht. Dieser MCP server verbindet sich mit der öffentlichen Thunderstore API, um Nutzern dabei zu helfen, Mods zu finden, komplexe Dependency-Trees zu verwalten und bestehende Mod-Listen auf Probleme wie veraltete Versionen oder fehlende Dateien zu prüfen. Er läuft lokal via Node.js für Claude Desktop und Cursor oder kann als Remote-Service über einen streamable HTTP Modus betrieben werden.
Nutzer interagieren mit spezifischen Tools wie search_mods, um Inhalte nach Owner oder Kategorie zu finden, und resolve_dependencies, um eine vollständige transitive Dependency-Closure zu berechnen. Der Server kann auch check_pack_health ausführen, um Konflikte oder veraltete Packages zu identifizieren. Sobald ein Pack fertig ist, generiert export_r2modman_profile eine .r2z-Datei für die Verwendung in r2modman oder dem Thunderstore Mod Manager. Das System nutzt einen lokalen Cache zur Geschwindigkeitsoptimierung, wobei das Laden großer Communities wie Lethal Company initial signifikanten Arbeitsspeicher und Zeit beansprucht.
Was du damit machen kannst
- 1Komplexe Abhängigkeiten auflösenBerechne jedes benötigte Package und jede Version, die erforderlich ist, damit eine spezifische Mod funktioniert.
- 2Mod-Listen auf Fehler prüfenÜberprüfe eine Liste von Mods, um veraltete Versionen, fehlende Dependencies oder doppelte Einträge zu finden.
- 3Community-Inhalte suchenFinde Mods innerhalb einer spezifischen Spiele-Community mithilfe von Keywords, Ownern oder Kategorien.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du PackWarden MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenPackWarden MCP in Claude Code installieren
$ claude mcp add packwarden -- npx -y @packwarden-dev/thunderstore-mcpPackWarden MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"packwarden": {
"command": "npx",
"args": [
"-y",
"@packwarden-dev/thunderstore-mcp"
]
}
}
}PackWarden MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"packwarden": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@packwarden-dev/thunderstore-mcp"
]
}
}
}PackWarden MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"packwarden","type":"stdio","command":"npx","args":["-y","@packwarden-dev/thunderstore-mcp"]}'PackWarden MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"packwarden": {
"command": "npx",
"args": [
"-y",
"@packwarden-dev/thunderstore-mcp"
]
}
}
}PackWarden MCP in Codex installieren
$ codex mcp add packwarden -- npx -y @packwarden-dev/thunderstore-mcpPackWarden MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.packwarden] command = "npx" args = ["-y", "@packwarden-dev/thunderstore-mcp"]
PackWarden MCP in Gemini CLI installieren
$ gemini mcp add -s user packwarden npx -- -y @packwarden-dev/thunderstore-mcpPackWarden MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"packwarden": {
"command": "npx",
"args": [
"-y",
"@packwarden-dev/thunderstore-mcp"
]
}
}
}PackWarden MCP tools 5
Erkannt aus dem READMElist_communitiessearch_modsresolve_dependenciescheck_pack_healthexport_r2modman_profile
| list_communities | — | |
| search_mods | — | |
| resolve_dependencies | — | |
| check_pack_health | — | |
| export_r2modman_profile | — |
Konfiguration
TEST_COMMUNITYTSMCP_EXPORT_DIR
| Name | Beschreibung | Typ |
|---|---|---|
| TEST_COMMUNITY | — | |
| TSMCP_EXPORT_DIR | — |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenPackWarden — 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.
PackWarden MCP Fragen
Wie füge ich PackWarden MCP zu Claude Code hinzu?
Führe claude mcp add packwarden -- npx -y @packwarden-dev/thunderstore-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich PackWarden MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet PackWarden MCP?
Er stellt 5 Tools bereit, darunter list_communities, search_mods, resolve_dependencies, check_pack_health, export_r2modman_profile.
Welche Spiele unterstützt PackWarden?
Es unterstützt jede Thunderstore-Community, einschließlich Lethal Company, Risk of Rain 2 und Valheim.
Wie exportiere ich meine Mod-Liste?
Der Server kann ein .r2z-Profil schreiben, das in r2modman oder den Thunderstore Mod Manager importiert werden kann.
Was sind die Hardware-Anforderungen für große Communities?
Das Laden großer Communities wie Lethal Company kann etwa 1,4 GB RAM benötigen und beim ersten Laden ca. 14 Sekunden dauern.