Superman MCP

⚠️ 면책 조항 (반드시 읽어주세요)

• 본 프로젝트는 개인 학습, 기술 연구 및 참고용으로만 제공되며, 상업적 용도나 법률/규정 위반, Cursor/관련 제3자 서비스 약관(ToS)을 위반하는 시나리오에 사용하는 것을 엄격히 금지합니다.

• 본 프로젝트는 오픈 소스 프로젝트 a78789191888/wkmcp-pjb를 기반으로 MIT 라이선스 하에 2차 수정, 통합 및 연구된 것이며, 모든 핵심 아이디어와 상위 코드의 저작권은 원작자에게 있습니다. 본 저장소는 학습 및 연구 목적의 복제본일 뿐입니다.

• 배포자는 소스 코드의 정리 및 재배포자일 뿐이며, 작성자 본인(현재 저장소 유지 관리자)과는 어떠한 이해관계도 없습니다. 본 코드의 사용, 수정, 배포로 인해 발생하는 직접적 또는 간접적 손실, 계정 정지, 법적 책임에 대해 어떠한 책임도 지지 않습니다.

• 본 저장소의 내용을 다운로드, 복제, 컴파일, 실행하거나 어떤 형태로든 사용하는 것은 귀하가 본 성명을 완전히 읽고 동의했음을 의미합니다. 위 약관에 동의하지 않으시면 즉시 사용을 중단하고 본 저장소의 모든 사본을 삭제하십시오.

• 본 프로젝트가 귀하의 합법적인 권리를 침해하는 경우, Issue를 통해 알려주시면 확인 후 즉시 관련 내용을 제거하겠습니다.

카드키 없는 버전의 Cursor 기능 향상 플러그인 · Superman MCP는 a78789191888/wkmcp-pjb를 기반으로 복제 및 강화되었습니다. 기존의 전체 사이드바 멀티 세션 MCP 기능을 유지하면서, Cursor 멤버십 유형 전환기(독립 페이지, 클릭 시 이동; 기존 Cursor Membership Switcher 프로젝트 기능 이식)가 내장되어 있습니다.

이 플러그인은 더 이상 카드키/활성화 코드/평가판 기간에 의존하지 않으며, 설치 즉시 사용할 수 있습니다.

상위 프로젝트 주소: https://github.com/a78789191888/wkmcp-pjb (MIT License, 본 저장소는 연구 및 학습 목적의 수정 버전이며 참고용입니다.)

Related MCP server: Cursor MCP Installer

기능

1. 사이드바 멀티 세션 MCP (wkmcp에서 유지)

• 다중 프로젝트, 다중 창 병렬 처리: 최대 32개 세션(my-mcp-1 … my-mcp-32), 각 독립적인 메시지 채널 바인딩

• check_messages / send_message / ask_question 3가지 MCP 도구, 첨부 파일(이미지/파일 base64) 지원

• 원클릭 "구성 시작"으로 현재 사이드바 세션 목록을 작업 공간 .cursor/mcp.json에 기록

• 세션 메모, 음성 입력(Windows), 채팅 기록 유지

2. Cursor 멤버십 전환기 (독립 페이지)

• 독립 설정 페이지: 사이드바에는 진입 버튼만 남기고, 클릭 시 편집 영역에서 전체 설정 페이지를 엽니다(사이드바 공간 점유 안 함).

• Cursor 설치 경로 자동 감지(실행 프로세스 + 일반 디렉토리)

• 원클릭 멤버십 유형 전환: Free / Free Trial / Pro / Pro+ / Ultra / Enterprise, 사용자 정의 문자열도 지원

• 원본 파일 자동 백업, 언제든지 원클릭 복구 가능

• 패치 적용 전 실행 중인 Cursor를 자동으로 확인하고 종료

• 원클릭 Cursor 재시작

3. Cursor 청구 및 사용량 (추가됨, 독립 페이지)

• 독립 청구 페이지: 사이드바에 "청구 및 사용량 열기" 버튼을 추가하여 편집 영역에서 엽니다.

• 로컬 state.vscdb 자동 읽기: cursorAuth/accessToken에서 현재 로그인된 Cursor 계정을 직접 가져옵니다(붙여넣기 불필요).

• 최초 설치 → 로컬 기록: cursorDiskKV의 composerData:*를 우선적으로 파싱하여 근사치 문자 가중치로 과거 토큰을 추정하여 빠르게 표시합니다.

• 이후 매번 → 공식 API: 적중 후 hasFetchedFromApi로 표시하여 로컬 캐시로 돌아가지 않습니다.

• 호출하는 Cursor API(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

• 표시 내용:

  • 계정 정보 카드: 이메일, 멤버십 유형, 구독 상태, WorkOS ID

  • 개요 KPI 카드: 오늘 / 이번 주 / 이번 달 / 총계의 $ 소비 + 토큰 수 + 횟수

  • 최근 30일 일일 소비 막대 그래프(순수 SVG, 차트 라이브러리 의존성 없음)

  • 모델별 세부 테이블: 횟수 / 입력 / 출력 / 캐시 읽기/쓰기 / 합계 토큰 / 소비 $

• 데이터 소스 표시: 페이지 상단 배지에 현재 데이터가 Cursor API(실시간) / 로컬 composerData(근사치) / 로컬 캐시 중 어디서 왔는지 명확히 표시

• 구현 세부 사항:

  • 내장 sql.js(wasm 사전 패키징, 약 690 KB)를 사용하여 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 멤버십 유형 → 멤버십 유형 설정 열기" 버튼을 클릭하고, 새 페이지에서 유형을 선택한 후 "패치 적용"을 클릭합니다.

5. 패치가 완료되면 "Cursor 재시작"을 클릭하여 적용합니다.

명령 팔레트

• Superman MCP: 配置工作区（MCP）

• Superman MCP: 打开主面板（独立页签）

• Superman MCP: 打开会员类型设置

• Superman MCP: 打开账单与用量

• Superman MCP: 应用会员补丁

• Superman MCP: 恢复原始会员文件

• Superman MCP: 检测 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 License) 본 프로젝트는 해당 프로젝트를 기반으로 연구 및 학습을 위해 수정되었으며, 참고용으로만 제공됩니다. 원작자의 오픈 소스 기여에 감사드립니다.

• 멤버십 전환 로직 참조: 본 저장소 legacy-python/ 하위의 아카이브 코드

• 청구 API 호출 참조: junhoyeo/tokscale

본 저장소는 MIT 라이선스에 따라 소스 코드 수준에서 2차 배포를 따릅니다(LICENSE.txt 참조).

다시 한번 강조

• 본 프로젝트는 학습, 연구, 기술 교류 목적으로만 사용해야 하며, 어떠한 불법적이거나 규정을 위반하는 용도, 상업적 용도로 사용할 수 없습니다.

• 본 프로젝트는 a78789191888/wkmcp-pjb의 연구 및 학습 목적 수정 버전이며, 참고용으로만 제공됩니다.

• 사용자는 본 프로젝트 사용으로 인해 발생하는 모든 위험(계정 위험, 법적 위험 등을 포함하되 이에 국한되지 않음)을 스스로 감수해야 하며, 어떠한 결과도 본 저장소 배포자/유지 관리자와는 무관합니다.

• 다운로드 후 24시간 이내에 삭제하고 Cursor 공식 정품 구독을 구매하여 지원해 주십시오.