modrinth-mcp

MCP-сервер, который оборачивает API Modrinth, позволяя ИИ-агенту (Claude Code, Claude Desktop, Cursor, …) искать проекты, читать метаданные проектов/версий и публиковать моды Minecraft — создавать проекты и загружать собранные jar-файлы как новые версии.

Инструменты

Инструменты только для чтения работают без токена. Всё, что записывает, требует Personal Access Token Modrinth.

Related MCP server: ModWrench MCP Server

Получение токена

Создайте PAT на https://modrinth.com/settings/pats со следующими областями доступа:

• Чтение проектов

• Чтение версий

• Создание версий

• Запись версий

Задайте его как переменную окружения MODRINTH_TOKEN.

Установка

Как плагин Claude Code

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

При включении плагина у вас запросят токен Modrinth. Под капотом он запускает опубликованный npm-пакет через npx.

Как MCP-сервер (любой клиент)

Добавьте в конфиг вашего MCP-клиента (например, Claude Desktop claude_desktop_config.json):

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

Или напрямую в Claude Code:

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

Переменные окружения

Пример рабочего процесса

1. modrinth_whoami — подтвердите, что аутентификация работает.

2. modrinth_create_project — создайте страницу проекта (создаётся как черновик).

3. modrinth_create_version — загрузите собранные jar-файлы с целевыми game_versions и loaders.

4. Отправьте проект на проверку на сайте Modrinth, когда будете готовы.

Примечание: create_version и create_project публикуют публичный контент. Вызывайте их только тогда, когда действительно собираетесь публиковать.

Разработка

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

Сервер общается по MCP через stdio. stdout зарезервирован для протокола; логи идут в stderr.

Лицензия

MIT