modrinth-mcp

Un servidor MCP que envuelve la API de Modrinth para que un agente de IA (Claude Code, Claude Desktop, Cursor, …) pueda buscar proyectos, leer metadatos de proyectos/versiones y publicar mods de Minecraft — crear proyectos y subir jars compilados como nuevas versiones.

Herramientas

Las herramientas de solo lectura funcionan sin token. Cualquier operación de escritura necesita un Token de Acceso Personal de Modrinth.

Related MCP server: ModWrench MCP Server

Obteniendo un token

Crea un PAT en https://modrinth.com/settings/pats con estos alcances:

• Leer proyectos

• Leer versiones

• Crear versiones

• Escribir versiones

Configúralo como la variable de entorno MODRINTH_TOKEN.

Instalación

Como plugin de Claude Code

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

Se te pedirá tu token de Modrinth al habilitar el plugin. Ejecuta el paquete npm publicado internamente mediante npx.

Como servidor MCP (cualquier cliente)

Añade a la configuración de tu cliente MCP (por ejemplo, claude_desktop_config.json de Claude Desktop):

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

O directamente en Claude Code:

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

Variables de entorno

Flujo de ejemplo

1. modrinth_whoami — confirma que la autenticación funciona.

2. modrinth_create_project — crea la página del proyecto (creada como borrador).

3. modrinth_create_version — sube tus jars compilados con los game_versions y loaders objetivo.

4. Envía el proyecto para revisión en el sitio de Modrinth cuando esté listo.

Nota: create_version y create_project publican contenido público. Solo llámalos cuando realmente tengas la intención de publicar.

Desarrollo

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

El servidor habla MCP sobre stdio. stdout está reservado para el protocolo; los registros van a stderr.

Licencia

MIT