Superman MCP

⚠️ Отказ от ответственности (обязательно к прочтению)

• Данный проект предназначен исключительно для личного обучения, технических исследований и ознакомления. Категорически запрещено использовать его в коммерческих целях или в сценариях, нарушающих законы, правила или Условия использования (ToS) Cursor / соответствующих сторонних сервисов.

• Данный проект основан на проекте с открытым исходным кодом a78789191888/wkmcp-pjb и был модифицирован, интегрирован и исследован в рамках лицензии MIT. Авторские права на все основные идеи и исходный код вышестоящего проекта принадлежат первоначальному автору. Данный репозиторий является лишь копией для целей обучения и исследований.

• Публикатор является лишь лицом, систематизировавшим и перевыложившим исходный код, и не имеет никаких интересов, связанных с автором (текущим сопровождающим репозитория). Он не несет никакой ответственности за любые прямые или косвенные убытки, блокировки аккаунтов или юридическую ответственность, возникшую у любого пользователя в результате использования, модификации или распространения данного кода.

• Скачивание, клонирование, компиляция, запуск или использование содержимого данного репозитория в любой форме означает, что вы полностью прочитали и согласились с данным заявлением; если вы не согласны с вышеуказанными условиями, немедленно прекратите использование и удалите все копии данного репозитория.

• Если данный проект нарушает ваши законные права, пожалуйста, создайте Issue, чтобы сообщить об этом, и после проверки соответствующий контент будет немедленно удален.

Улучшенный плагин Cursor без необходимости ввода ключа активации · Superman MCP, основан на форке и улучшении a78789191888/wkmcp-pjb. Сохраняя все функции многосессионного MCP на боковой панели, он также включает встроенный переключатель типа подписки Cursor (отдельная страница, переход по клику; портировано из проекта Cursor Membership Switcher).

Плагин больше не зависит от каких-либо ключей/кодов активации/пробных периодов, работает сразу после открытия.

Адрес вышестоящего проекта: https://github.com/a78789191888/wkmcp-pjb (Лицензия MIT, данный репозиторий является модифицированной версией для изучения и исследований, только для справки)

Related MCP server: Cursor MCP Installer

Функции

1. Многосессионный MCP на боковой панели (сохранено из wkmcp)

• Параллельная работа с несколькими проектами и окнами: до 32 сессий (my-mcp-1 … my-mcp-32), каждая с независимым каналом сообщений

• Три инструмента MCP: check_messages / send_message / ask_question, поддержка вложений (изображения/файлы в base64)

• Функция «Начать настройку» в один клик для записи текущего списка сессий боковой панели в .cursor/mcp.json рабочего пространства

• Заметки к сессиям, голосовой ввод (Windows), сохранение истории чатов

2. Переключатель подписки Cursor (отдельная страница)

• Отдельная страница настроек: на боковой панели остается только кнопка входа, при нажатии открывается полная страница настроек в области редактирования (не занимает место на боковой панели)

• Автоматическое определение пути установки Cursor (запущенные процессы + стандартные директории)

• Переключение типа подписки в один клик: Free / Free Trial / Pro / Pro+ / Ultra / Enterprise, также поддерживаются произвольные строки

• Автоматическое резервное копирование исходных файлов, возможность восстановления в один клик

• Автоматический запрос на закрытие запущенного Cursor перед применением патча

• Перезапуск Cursor в один клик

3. Счета и использование Cursor (новое, отдельная страница)

• Отдельная страница счетов: добавлена кнопка «Открыть счета и использование» на боковой панели, открывается в области редактирования

• Автоматическое чтение локального state.vscdb: получение текущего авторизованного аккаунта Cursor напрямую из cursorAuth/accessToken (без необходимости вставки)

• Первая установка → локальная запись: приоритетный разбор composerData:* из cursorDiskKV, приблизительная оценка исторических токенов по весам символов для быстрого отображения

• Последующие обращения → официальный API: после успешного получения ставится метка hasFetchedFromApi, возврат к локальному кэшу больше не происходит

• Вызываемые API Cursor (согласно реализации Open Switch и tokscale):

  • POST https://api2.cursor.sh/aiserver.v1.AuthService/GetUserMeta

  • GET https://api2.cursor.sh/auth/full_stripe_profile

  • GET https://cursor.com/api/usage-summary

  • GET https://cursor.com/api/dashboard/export-usage-events-csv?strategy=tokens

• Отображаемый контент:

  • Карточка информации об аккаунте: email, тип подписки, статус подписки, WorkOS ID

  • Карточка KPI: Сегодня / На этой неделе / В этом месяце / Всего в $ + количество токенов + количество запросов

  • Столбчатая диаграмма потребления за последние 30 дней (чистый SVG, без зависимостей от библиотек графиков)

  • Таблица детализации по моделям: количество запросов / вход / выход / чтение-запись кэша / итого токенов / потребление $

• Метка источника данных: бейдж в верхней части страницы четко указывает, откуда получены данные: API Cursor (в реальном времени) / Локальные composerData (приблизительно) / Локальный кэш

• Детали реализации:

  • Использование встроенного sql.js (предварительно упакованный wasm, около 690 КБ) для чтения state.vscdb, чтение только для копирования в Buffer, без блокировки Cursor

  • Использование встроенного в Node модуля https для вызова API, без других зависимостей npm во время выполнения

  • Автоматическая повторная попытка при сбое API (устойчивость к колебаниям TLS / сокетов)

Сборка и упаковка

Требования к окружению

• Node.js 18+ (требуется встроенный npm)

• Windows / macOS / Linux; в Windows рекомендуется использовать PowerShell

• Глобальная установка vsce не требуется, он подтягивается как devDependencies вместе с пакетом (@vscode/vsce)

Упаковка в один клик

npm install          # 安装根依赖 + 触发 postinstall 安装 mcp-server 子包依赖
npm run compile      # 1) tsc -p . 编译 src/ → dist/   2) 执行 scripts/copy-vendor.js
npm run package      # 等价于 compile + vsce package --no-dependencies --allow-missing-repository

После успешной упаковки в корневом каталоге репозитория появится:

cursor-free-plus-1.4.0.vsix   （版本号取自 package.json 的 "version"）

Использование

Также можно полностью отказаться от Cursor и использовать отдельное настольное приложение, подробности см. в desktop-app/README.md.

1. После установки на панели активности слева появится иконка Superman MCP, нажмите, чтобы открыть боковую панель.

2. (Опционально) Если вам привычнее большое окно: выполните в палитре команд Superman MCP: 打开主面板（独立页签） (Открыть главную панель (отдельная вкладка)), это откроет тот же интерфейс, что и на боковой панели, в области редактирования (можно перетаскивать, разделять экран и смотреть рядом с кодом).

3. Введите путь к рабочему пространству или выберите «Использовать текущее», нажмите «Начать настройку» для записи в .cursor/mcp.json.

4. Нажмите кнопку «Cursor 会员类型 → 打开会员类型设置» (Тип подписки Cursor → Открыть настройки типа подписки), выберите тип на новой странице и нажмите «Применить патч».

5. После завершения патчинга нажмите «Перезапустить Cursor», изменения вступят в силу после перезапуска.

Палитра команд

• Superman MCP: 配置工作区（MCP） (Настроить рабочее пространство (MCP))

• Superman MCP: 打开主面板（独立页签） (Открыть главную панель (отдельная вкладка))

• Superman MCP: 打开会员类型设置 (Открыть настройки типа подписки)

• Superman MCP: 打开账单与用量 (Открыть счета и использование)

• Superman MCP: 应用会员补丁 (Применить патч подписки)

• Superman MCP: 恢复原始会员文件 (Восстановить исходные файлы подписки)

• Superman MCP: 检测 Cursor 安装路径 (Определить путь установки Cursor)

Параметры конфигурации

• wukong.payStoreUrl: URL для перехода по кнопке «Спонсорство/Покупка» на боковой панели, по умолчанию https://pay.ldxp.cn/shop/superman

• cursorFree.supportGroupQQ: Номер QQ группы поддержки, по умолчанию 1087432681

• cursorFree.defaultMembership: Тип подписки, выбранный по умолчанию, по умолчанию pro

Остальные параметры конфигурации wukong.* сохранены для совместимости с вышестоящим проектом wkmcp и не действуют в версии без ключа активации.

Структура каталогов

Cursor-free/
├── package.json              # 扩展 manifest（命令、视图、配置、scripts 全在这）
├── tsconfig.json             # TypeScript 编译配置（outDir = dist/）
├── .vscodeignore             # vsce 打包排除清单
├── src/                      # TS 源码（编译到 dist/ 后被打进 vsix）
│   ├── extension.ts          # 扩展主入口（复刻自 wkmcp + 集成会员切换 / 账单 UI）
│   ├── license.ts            # 短路化的 license 模块（保留签名，一律永久已激活）
│   └── cursor-patcher.ts     # 会员补丁逻辑（从 Python 项目移植到 Node）
├── scripts/
│   ├── copy-vendor.js        # 把 sql.js 的 wasm 拷贝到 dist/vendor/sql.js/
│   └── smoke-billing.js      # 账单页接口 / 本地数据源冒烟脚本
├── dist/                     # 构建产物（进 vsix 的就是这一坨 + mcp-server/）
│   ├── extension.js
│   ├── license.js
│   ├── cursor-patcher.js
│   └── vendor/sql.js/        # sql-wasm.js + sql-wasm.wasm
├── mcp-server/
│   ├── index.mjs             # MCP stdio server（原样保留）
│   └── package.json
├── resources/icon.svg
├── legacy-python/            # 原 Python GUI 项目归档（不参与打包）
└── ref-wkmcp-pjb/            # wkmcp 参考源（仅作参照，不参与打包）

Общение и поддержка

• QQ группа для общения: 1087432681

• Спонсорство / Покупка: https://pay.ldxp.cn/shop/superman

Благодарности и лицензия

• Вышестоящий оригинальный проект: a78789191888/wkmcp-pjb (Лицензия MIT) Данный проект является модифицированной версией на основе вышеуказанного проекта для целей изучения и исследований, только для справки. Благодарим первоначального автора за вклад в Open Source.

• Логика переключения подписки: архивированный код в legacy-python/ данного репозитория

• Вызовы API счетов: [junhoyeo/tokscale](https://github.com