{"id":49223504,"url":"https://github.com/2029193370/cursor-mcp","last_synced_at":"2026-04-24T05:04:45.088Z","repository":{"id":351962943,"uuid":"1213253694","full_name":"2029193370/cursor-mcp","owner":"2029193370","description":"Multi-channel MCP sidebar for Cursor: concurrent workspaces, per-window binding, images/files, session memos.","archived":false,"fork":false,"pushed_at":"2026-04-17T09:03:31.000Z","size":89,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T09:37:13.995Z","etag":null,"topics":["ai","ai-tools","chat","cursor","cursor-extension","cursor-ide","developer-tools","llm","mcp","model-context-protocol","multi-session","sidebar","vscode-extension"],"latest_commit_sha":null,"homepage":"https://github.com/2029193370/cursor-mcp","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/2029193370.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-17T07:34:25.000Z","updated_at":"2026-04-17T09:03:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/2029193370/cursor-mcp","commit_stats":null,"previous_names":["2029193370/cursor-mcp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/2029193370/cursor-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2029193370%2Fcursor-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2029193370%2Fcursor-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2029193370%2Fcursor-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2029193370%2Fcursor-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/2029193370","download_url":"https://codeload.github.com/2029193370/cursor-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/2029193370%2Fcursor-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32209897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T03:15:14.334Z","status":"ssl_error","status_checked_at":"2026-04-24T03:15:11.608Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-tools","chat","cursor","cursor-extension","cursor-ide","developer-tools","llm","mcp","model-context-protocol","multi-session","sidebar","vscode-extension"],"created_at":"2026-04-24T05:04:36.682Z","updated_at":"2026-04-24T05:04:45.070Z","avatar_url":"https://github.com/2029193370.png","language":"JavaScript","readme":"\u003cdiv align=\"center\"\u003e\n\n# Cursor MCP\n\n**Multi-channel MCP sidebar for Cursor** — concurrent workspaces, per-window binding, images \u0026 files, session memos.\n\n**Cursor 侧栏多路 MCP** — 多项目/多工作区并行、多窗口独立通道、消息随附截图与文件。\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE.txt)\n[![Release](https://img.shields.io/github/v/release/2029193370/cursor-mcp?display_name=tag\u0026sort=semver)](https://github.com/2029193370/cursor-mcp/releases)\n[![Stars](https://img.shields.io/github/stars/2029193370/cursor-mcp?style=social)](https://github.com/2029193370/cursor-mcp/stargazers)\n[![Issues](https://img.shields.io/github/issues/2029193370/cursor-mcp)](https://github.com/2029193370/cursor-mcp/issues)\n\n[English](#english) · [中文](#中文)\n\n\u003c/div\u003e\n\n---\n\n\u003ca id=\"english\"\u003e\u003c/a\u003e\n\n## ✨ Highlights\n\n- 🎛 **Up to 32 parallel MCP channels** in one sidebar — `cursor-mcp-1` … `cursor-mcp-N`\n- 🪟 **Per-window binding** — each Cursor chat window binds to exactly one channel, no cross-talk\n- 🗂 **Workspace-aware** — one click writes `.cursor/mcp.json` + rule file for the current project\n- 🖼 **Images \u0026 files** can be attached to every message\n- 📝 **Session memos** per channel to remember what each one is for\n- 🔑 **Optional licensing** — HMAC key (`CMC1.`) or your own cloud redeem API. Comes **empty by default**, so it’s fully free/open-source out of the box\n\n---\n\n## 🚀 Quick Start\n\nRequires [Node.js](https://nodejs.org) ≥ 16.\n\n**Option A — Download the prebuilt `.vsix`**\n\nHead to [Releases](https://github.com/2029193370/cursor-mcp/releases) → download the latest `cursor-mcp-*.vsix` → drag it into Cursor’s Extensions panel.\n\n**Option B — Build locally**\n\n```bash\ngit clone https://github.com/2029193370/cursor-mcp.git\ncd cursor-mcp\nnpm install\nnpm run compile\nnpx vsce package --no-dependencies --allow-missing-repository\n```\n\nThen install the generated `cursor-mcp-1.0.0.vsix` into Cursor.\n\n---\n\n## 📖 Usage\n\n1. Click the **Cursor MCP** icon in Cursor’s activity bar.\n2. Pick a workspace (or use the current one).\n3. Click **Configure workspace** → the extension writes:\n   - `.cursor/mcp.json` with `cursor-mcp-1 … cursor-mcp-N`\n   - `.cursor/rules/cursor-mcp.mdc` — rule that keeps the `check_messages` loop alive\n4. In a Cursor chat window, say: `请使用 cursor-mcp-1 的 check_messages`\n5. Switch back to the sidebar and start chatting — messages are delivered to the bound window in real time.\n\n---\n\n## ⚙️ Settings\n\nOpen Cursor Settings and search **\"Cursor MCP\"**:\n\n| Key | Purpose |\n| --- | --- |\n| `cursorMcp.licenseSecret` | HMAC secret (must match the one used to generate keys) |\n| `cursorMcp.adminPassword` | Admin password gate for key-gen / clear-license |\n| `cursorMcp.redeemApiBaseUrl` | Your own cloud redeem API root (expects `/api/redeem`, `/api/license/verify`) |\n| `cursorMcp.payStoreUrl` | URL opened when users click *\"Buy online\"* in the sidebar |\n| `cursorMcp.redeemTimeoutMs` | Cloud redeem timeout (3000–120000 ms) |\n| `cursorMcp.cloudLicenseOnly` | `true` = reject local `CMC1.` keys, force cloud redeem |\n| `cursorMcp.cloudLicenseVerifyIntervalMs` | Interval for revocation check (default 15 min) |\n\n\u003e **No default secret or paid server is bundled.** Configure your own or leave empty to run fully free.\n\n---\n\n## 🏗 Architecture\n\n```\ncursor-mcp/\n├── src/\n│   ├── extension.js     Sidebar UI, webview, command wiring\n│   └── license.js       HMAC + cloud redeem + trial logic\n├── mcp-server/\n│   ├── index.mjs        MCP process: check_messages / send_message / ask_question\n│   └── package.json\n├── resources/\n│   └── icon.svg         Extension icon\n└── package.json         Extension manifest\n```\n\nThe sidebar and each `cursor-mcp-N` MCP process communicate through a file-based queue under `~/.cursor/cursor-mcp-messages/s/\u003cid\u003e/`, which keeps things stable even when Cursor restarts connections.\n\n---\n\n## 🤝 Contributing\n\nIssues and PRs welcome — feel free to open a ticket describing bugs or feature ideas.\n\n## 📄 License\n\n[MIT](./LICENSE.txt) © 2026 litingfeng\n\n---\n\n\u003ca id=\"中文\"\u003e\u003c/a\u003e\n\n## ✨ 核心特性\n\n- 🎛 **最多 32 路并行 MCP 通道**，侧栏统一管理 `cursor-mcp-1` … `cursor-mcp-N`\n- 🪟 **每个 Cursor 窗口独立绑定**一路通道，互不串扰\n- 🗂 **工作区感知** —— 一键写入当前项目的 `.cursor/mcp.json` 与规则文件\n- 🖼 消息可随附 **图片 + 文件**\n- 📝 每路会话独立 **备忘** ，记录这路用来做什么\n- 🔑 **可选卡密体系** —— 支持本地 HMAC（`CMC1.`）或自建云端核销；默认全部留空，即开箱可用的免费版\n\n## 🚀 快速开始\n\n需要 [Node.js](https://nodejs.org) ≥ 16。\n\n**方式 A — 下载现成的 `.vsix`**\n\n前往 [Releases](https://github.com/2029193370/cursor-mcp/releases) → 下载最新 `cursor-mcp-*.vsix` → 拖入 Cursor 扩展面板。\n\n**方式 B — 本地打包**\n\n```bash\ngit clone https://github.com/2029193370/cursor-mcp.git\ncd cursor-mcp\nnpm install\nnpm run compile\nnpx vsce package --no-dependencies --allow-missing-repository\n```\n\n## 📖 使用步骤\n\n1. 点击 Cursor 活动栏中的 **Cursor MCP** 图标\n2. 选择或使用当前工作区\n3. 点击 **开始配置**，扩展会生成 `.cursor/mcp.json` 和 `.cursor/rules/cursor-mcp.mdc`\n4. 在 Cursor 对话窗口说：`请使用 cursor-mcp-1 的 check_messages`\n5. 回到侧栏发消息 —— 绑定窗口实时接收\n\n## ⚙️ 配置项\n\n在 Cursor 设置中搜索 **\"Cursor MCP\"**，主要配置见上方英文表格；**默认不携带任何发卡地址和密钥**，如果不启用付费体系留空即可。\n\n## 📄 许可证\n\n[MIT](./LICENSE.txt) © 2026 litingfeng\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2029193370%2Fcursor-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F2029193370%2Fcursor-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F2029193370%2Fcursor-mcp/lists"}