Nexusmods MCP

nexusmods-mcp


MCP-сервер на Go для Nexus Mods: REST v1 (игры, мод, файлы, changelog, ленты, отслеживаемые моды, лимиты) и GraphQL v2 (поиск с фильтрами, зависимости мода, расширенная карточка mod).

• stdio (по умолчанию): docker run -i — Cursor, OpenClaw, mcp-smoke.
• HTTP (MCP_TRANSPORT=http): streamable HTTP для клиентов с поддержкой; см. docs/MCP.md. Не публикуй порт без защиты.

Код: cmd/server, internal/nexus, internal/toolreg.

Tools (17): nexus_games, nexus_search_mods, nexus_get_mod, nexus_get_mod_graphql, nexus_list_mod_files, nexus_get_mod_file, nexus_get_mod_changelog, nexus_get_mod_requirements, nexus_get_game, nexus_game_categories, nexus_mods_latest_updated, nexus_mods_latest_added, nexus_mods_trending, nexus_mods_recently_updated, nexus_get_tracked_mods, nexus_get_rate_limits, nexus_invalidate_cache — контракт в docs/MCP.md.

Быстрый старт

Из каталога репозитория (удобно держать клон на ext4 в WSL, например ~/nexusmods-mcp):

cd ~/nexusmods-mcp
docker build -t nexus-mcp:local .
docker run --rm -i \
  -e NEXUSMODS_API_KEY="YOUR_KEY" \
  -e NEXUSMODS_APPLICATION_NAME="nexusmods-mcp-local" \
  -e NEXUSMODS_APPLICATION_VERSION="0.1.0" \
  nexus-mcp:local

Флаг -i нужен, чтобы клиент подключился к stdin MCP.

Шаблон переменных: .env.example. Ключ API: Account → API. Ответы API по умолчанию кешируются в памяти 24h (NEXUSMODS_CACHE_TTL) — подробности в docs/MCP.md.

После обновления кода снова собери образ или бинарь — иначе Cursor продолжит показывать старый список tools из tools/list. См. docs/MCP.md (типичные ошибки).

Документация

• docs/MCP.md — транспорты, переменные окружения, контракт tools, Cursor, Claude Desktop, отладка, типичные ошибки
• TESTING.md — go test, Docker, mcp-smoke, матрица сбоев
• AGENT-TEST-PLAYBOOK.md — короткий чеклист A→D

Примеры конфигурации MCP-клиентов

Не коммить реальные ключи. Nexus API acceptable use.

Локальная разработка (Go 1.26+)

go build -o nexusmods-mcp ./cmd/server
NEXUSMODS_API_KEY=... ./nexusmods-mcp

Smoke по stdio: см. TESTING.md.