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 (16): 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 — контракт в 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.

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

| Файл | Назначение | |------|------------| | cursor-mcp.json.example | Cursor: ключ в -e | | [cursor-mcp-envfi