modrinth-mcp

Ein MCP-Server, der die Modrinth-API kapselt, sodass ein KI-Agent (Claude Code, Claude Desktop, Cursor, …) Projekte durchsuchen, Projekt-/Versionsmetadaten lesen und Minecraft-Mods veröffentlichen kann – Projekte erstellen und erstellte JARs als neue Versionen hochladen.

Tools

Schreibgeschützte Tools funktionieren ohne Token. Alles, was schreibt, benötigt ein Modrinth-Personal-Access-Token.

Related MCP server: ModWrench MCP Server

Ein Token erhalten

Erstelle ein PAT unter https://modrinth.com/settings/pats mit folgenden Berechtigungen:

• Projekte lesen

• Versionen lesen

• Versionen erstellen

• Versionen schreiben

Setze es als Umgebungsvariable MODRINTH_TOKEN.

Installation

Als Claude-Code-Plugin

/plugin marketplace add justinscott12/modrinth-mcp
/plugin install modrinth-mcp@justinscott12

Du wirst beim Aktivieren des Plugins nach deinem Modrinth-Token gefragt. Es führt das veröffentlichte npm-Paket im Hintergrund über npx aus.

Als MCP-Server (beliebiger Client)

Füge Folgendes zu deiner MCP-Client-Konfiguration hinzu (z. B. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "modrinth": {
      "command": "npx",
      "args": ["-y", "@justinscott12/modrinth-mcp"],
      "env": {
        "MODRINTH_TOKEN": "your-modrinth-pat"
      }
    }
  }
}

Oder direkt in Claude Code:

claude mcp add modrinth --env MODRINTH_TOKEN=your-modrinth-pat -- npx -y @justinscott12/modrinth-mcp

Umgebungsvariablen

Beispielablauf

1. modrinth_whoami – bestätigt, dass die Authentifizierung funktioniert.

2. modrinth_create_project – erstellt die Projektseite (wird als Entwurf erstellt).

3. modrinth_create_version – lade deine erstellten JAR(s) mit den Ziel-game_versions und loaders hoch.

4. Reiche das Projekt zur Überprüfung auf der Modrinth-Website ein, sobald es bereit ist.

Hinweis: create_version und create_project veröffentlichen öffentliche Inhalte. Rufe sie nur auf, wenn du tatsächlich veröffentlichen möchtest.

Entwicklung

npm install
MODRINTH_STAGING=1 MODRINTH_TOKEN=your-staging-pat npm start

Der Server spricht MCP über stdio. stdout ist für das Protokoll reserviert; Logs gehen an stderr.

Lizenz

MIT