Superman MCP

⚠️ 免責事項（必ずお読みください）

• 本プロジェクトは個人の学習、技術研究、および参考目的のみに使用してください。商用利用、法律や規制への違反、またはCursorや関連するサードパーティの利用規約（ToS）に違反するようなシナリオでの使用は固く禁じられています。

• 本プロジェクトは、オープンソースプロジェクト a78789191888/wkmcp-pjb をMITライセンスの下で二次改変、統合、研究したものです。すべての核心的なアイデアおよび上流コードの著作権は原作者に帰属します。 本リポジトリは学習・研究目的のフォークサンプルとしてのみ提供されます。

• 発行者はソースコードの整理および転載者であり、作者本人（現在のリポジトリのメンテナー）とは一切の利害関係がありません。 本コードの使用、改変、拡散によって生じた直接的または間接的な損失、アカウントの停止、法的責任について、一切の責任を負いません。

• 本リポジトリの内容をダウンロード、クローン、コンパイル、実行、または何らかの形で使用することは、本声明をすべて読み、同意したものとみなされます。 上記の条項に同意できない場合は、直ちに使用を中止し、本リポジトリのすべてのコピーを削除してください。

• 本プロジェクトがお客様の正当な権利を侵害している場合は、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失敗時に自動で1回再試行（TLS / socketの揺らぎを許容）

ビルドとパッケージング

環境要件

• 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ライセンスに従います（LICENSE.txt を参照）。

再度の免責事項

• 本プロジェクトは学習、研究、技術交流のみを目的としており、違法・不正な用途や商用利用は固く禁じられています。

• 本プロジェクトは a78789191888/wkmcp-pjb の研究・学習目的の改変版であり、参考用です。

• 使用者は、本プロジェクトの使用に伴うすべてのリスク（アカウントリスク、法的リスクを含むがこれらに限定されない）を自己責任で負うものとし、いかなる結果も本リポジトリの発行者/メンテナーとは無関係です。

• ダウンロード後24時間以内に削除し、Cursorの公式サブスクリプションを購入してサポートしてください。