Superman MCP

⚠️ Disclaimer (Please Read Carefully)

• This project is for personal learning, technical research, and reference purposes only. It is strictly prohibited to use this project for any commercial purposes, or in scenarios that violate laws, regulations, or the Terms of Service (ToS) of Cursor or related third-party services.

• This project is a secondary modification, integration, and research effort based on the open-source project a78789191888/wkmcp-pjb under the MIT License. All core concepts and copyrights of the upstream code belong to the original author. This repository serves only as a fork for learning and research purposes.

• The publisher is merely an organizer and re-uploader of the source code and has no interest relationship with the author (the current maintainer of this repository). The publisher assumes no responsibility for any direct or indirect losses, account bans, or legal liabilities caused by any user's use, modification, or dissemination of this code.

• By downloading, cloning, compiling, running, or using the contents of this repository in any form, you are deemed to have read and agreed to this statement in its entirety. If you do not agree to the above terms, please stop using it immediately and delete all copies of this repository.

• If this project infringes upon your legal rights, please submit an Issue to notify us, and the relevant content will be removed immediately after verification.

Keyless Cursor Enhancement Plugin · Superman MCP, forked and enhanced from a78789191888/wkmcp-pjb. While retaining all of its sidebar multi-session MCP functionality, it includes a built-in Cursor Membership Switcher (independent page, click to navigate; ported from the original Cursor Membership Switcher project).

This plugin no longer relies on any keys/activation codes/trial periods; it is ready to use upon opening.

Upstream project address: https://github.com/a78789191888/wkmcp-pjb (MIT License, this repository is a research-oriented modified version for reference only)

Related MCP server: Cursor MCP Installer

Features

1. Sidebar Multi-Session MCP (Retained from wkmcp)

• Parallel multi-project, multi-window support: Up to 32 sessions (my-mcp-1 … my-mcp-32), each with independent message channels.

• Three MCP tools: check_messages / send_message / ask_question, supporting attachments (images/files in base64).

• One-click "Start Configuration" to write the current sidebar session list to the workspace .cursor/mcp.json.

• Session memos, voice input (Windows), and persistent chat history.

2. Cursor Membership Switcher (Independent Page)

• Independent Settings Page: The sidebar only keeps an entry button. Clicking it opens the full settings page in the editor area (no longer occupying sidebar space).

• Automatic detection of Cursor installation path (running processes + common directories).

• One-click membership type switching: Free / Free Trial / Pro / Pro+ / Ultra / Enterprise, also supports custom strings.

• Automatic backup of original files, with one-click restoration at any time.

• Automatically prompts to close running Cursor instances before applying patches.

• One-click Cursor restart.

3. Cursor Billing and Usage (New, Independent Page)

• Independent Billing Page: An additional "Open Billing and Usage" button in the sidebar, opening in the editor area.

• Automatic reading of local state.vscdb: Retrieves the currently logged-in Cursor account directly from cursorAuth/accessToken (no pasting required).

• First Installation → Local Records: Prioritizes parsing composerData:* in cursorDiskKV, estimating historical tokens based on character weights for quick display.

• Subsequent Visits → Official API: Marks hasFetchedFromApi after a successful hit, no longer falling back to local cache.

• Cursor APIs Called (referencing Open Switch implementation and 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

• Displayed Content:

  • Account Info Card: Email, membership type, subscription status, WorkOS ID.

  • Overview KPI Card: Today / This Week / This Month / Total $ consumption + token count + request count.

  • Bar chart of daily consumption for the last 30 days (pure SVG, no chart library dependency).

  • Model breakdown table: Requests / Input / Output / Cache Read/Write / Total Tokens / Consumption $.

• Data Source Labeling: A badge at the top of the page clearly indicates whether the current data is from Cursor API (Real-time) / Local composerData (Approximate) / Local Cache.

• Implementation Details:

  • Uses embedded sql.js (pre-packaged wasm, ~690 KB) to read state.vscdb, reading into a Buffer without locking Cursor.

  • Uses Node's built-in https to call APIs, with no other npm runtime dependencies.

  • Automatic retry once on API failure (tolerance for TLS / socket jitter).

Build and Packaging

Environment Requirements

• Node.js 18+ (requires npm)

• Windows / macOS / Linux are all supported; PowerShell is recommended for Windows.

• No need to install vsce globally; it is pulled as a devDependencies (@vscode/vsce).

One-Click Packaging

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

After successful packaging, you will get the following in the root directory:

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

Usage

You can also use it completely independently of Cursor as a standalone desktop application. See desktop-app/README.md for details.

1. After installation, the Superman MCP icon will appear in the left activity bar. Click it to open the sidebar.

2. (Optional) If you prefer a larger window: Run Superman MCP: Open Main Panel (Independent Tab) from the command palette. This opens the same main interface as the sidebar in the editor area (can be dragged to split-screen, viewed side-by-side with code).

3. Enter the workspace path or select "Use Current", then click "Start Configuration" to write to .cursor/mcp.json.

4. Click the "Cursor Membership Type → Open Membership Type Settings" button, select the type in the new page, and click "Apply Patch".

5. Click "Restart Cursor" after the patch is applied.

Command Palette

• Superman MCP: Configure Workspace (MCP)

• Superman MCP: Open Main Panel (Independent Tab)

• Superman MCP: Open Membership Type Settings

• Superman MCP: Open Billing and Usage

• Superman MCP: Apply Membership Patch

• Superman MCP: Restore Original Membership Files

• Superman MCP: Detect Cursor Installation Path

Configuration Items

• wukong.payStoreUrl: The URL for the "Sponsor/Purchase" link in the sidebar, default https://pay.ldxp.cn/shop/superman

• cursorFree.supportGroupQQ: QQ group number, default 1087432681

• cursorFree.defaultMembership: Default selected membership type, default pro

Other wukong.* configuration items are retained for compatibility with the upstream wkmcp and do not take effect in the keyless version.

Directory Structure

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 参考源（仅作参照，不参与打包）

Communication and Support

• QQ Discussion Group: 1087432681

• Sponsor / Purchase: https://pay.ldxp.cn/shop/superman

Acknowledgments and License

• Upstream Original Project: a78789191888/wkmcp-pjb (MIT License) This project is a modification based on the original for research and learning purposes, for reference only. Thanks to the original author for their open-source contribution.

• Membership switching logic reference: Archived code under legacy-python/ in this repository.

• Billing API call reference: junhoyeo/tokscale

This repository follows the MIT License for secondary distribution at the source code level (see LICENSE.txt).

Final Disclaimer

• This project is for learning, research, and technical exchange purposes only. It must not be used for any illegal or non-compliant purposes, nor for any commercial purposes.

• This project is a research-oriented modification of a78789191888/wkmcp-pjb and is for reference only.

• Users shall bear all risks associated with using this project (including but not limited to account risks and legal risks). Any consequences are unrelated to the publisher/maintainer of this repository.

• Please delete it within 24 hours after downloading and support the official Cursor subscription.