English Français العربية

io.github.justinscott12/modrinth-mcp

Registre officiel Recherche et web

Search Modrinth and publish Minecraft mods (create projects, upload versions) via the Modrinth API.

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 @justinscott12/modrinth-mcp
Claude Code 
claude mcp add modrinth-mcp -e 'MODRINTH_TOKEN=<your modrinth_token>' -- npx -y @justinscott12/modrinth-mcp@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "modrinth-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@justinscott12/modrinth-mcp@0.1.1"
            ],
            "env": {
                "MODRINTH_TOKEN": "<your modrinth_token>"
            }
        }
    }
}

Variables d'environnement

  • MODRINTH_TOKEN secret Modrinth Personal Access Token (https://modrinth.com/settings/pats). Required only for write actions; read-only tools work without it.

Documentation

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

Sommaire
  1. modrinth-mcp
  2. Tools
  3. Getting a token
  4. Install
  5. Environment variables
  6. Example flow
  7. Development
  8. License

modrinth-mcp

An MCP server that wraps the Modrinth API so an AI agent (Claude Code, Claude Desktop, Cursor, …) can search projects, read project/version metadata, and publish Minecraft mods — create projects and upload built jars as new versions.

Tools

ToolAuthWhat it does
modrinth_whoami✅Verify your token; return the authenticated user.
modrinth_search_projects–Search public Modrinth projects.
modrinth_get_project–Get a project's metadata by slug or id.
modrinth_list_project_versions–List a project's published versions.
modrinth_create_version✅Publish a new version by uploading one or more jars.
modrinth_create_project✅Create a new project (as a draft).
modrinth_modify_version✅Edit metadata of an existing version.

Read-only tools work without a token. Anything that writes needs a Modrinth Personal Access Token.

Getting a token

Create a PAT at https://modrinth.com/settings/pats with these scopes:

  • Read projects
  • Read versions
  • Create versions
  • Write versions

Set it as the MODRINTH_TOKEN environment variable.

Install

As a Claude Code plugin
/plugin marketplace add justinscott12/modrinth-mcp
/plugin install modrinth-mcp@justinscott12

It runs the published npm package under the hood via npx. Claude Code plugins have no token-entry UI, so the server reads its token from the MODRINTH_TOKEN environment variable in the environment Claude Code runs in. Set it before launching Claude Code, e.g.:

# macOS/Linux (add to your shell profile to persist)
export MODRINTH_TOKEN=your-modrinth-pat

# Windows PowerShell (persist for your user)
setx MODRINTH_TOKEN "your-modrinth-pat"

Then restart Claude Code and run modrinth_whoami to confirm. Read-only tools (search, get project/versions) work without a token.

As an MCP server (any client)

Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

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

Or in Claude Code directly:

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

Environment variables

VariableDefaultPurpose
MODRINTH_TOKEN–Modrinth Personal Access Token. Required for write actions.
MODRINTH_STAGINGunsetSet to 1 to hit https://staging-api.modrinth.com for safe testing.
MODRINTH_USER_AGENTmodrinth-mcp/<version> …Override the User-Agent sent to Modrinth.

Example flow

  1. modrinth_whoami — confirm auth works.
  2. modrinth_create_project — create the project page (created as a draft).
  3. modrinth_create_version — upload your built jar(s) with the target game_versions and loaders.
  4. Submit the project for review on the Modrinth site when ready.

Note: create_version and create_project publish public content. Only call them when you actually intend to publish.

Development

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

The server speaks MCP over stdio. stdout is reserved for the protocol; logs go to stderr.

License

MIT

Questions fréquentes

Qu'est-ce que io.github.justinscott12/modrinth-mcp ?

Search Modrinth and publish Minecraft mods (create projects, upload versions) via the Modrinth API.

Comment installer io.github.justinscott12/modrinth-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add modrinth-mcp -e 'MODRINTH_TOKEN=<your modrinth_token>' -- npx -y @justinscott12/modrinth-mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.justinscott12/modrinth-mcp ?

Oui. Il attend MODRINTH_TOKEN, à renseigner dans sa configuration.

io.github.justinscott12/modrinth-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.justinscott12/modrinth-mcp ?

Il est publié par justinscott12. 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.