mcp光标消息
用于光标和VS代码的MCP侧信道聊天。 将侧边栏中的消息排队，让您的代理使用 check_messages，运行结构化 ask_question 无需在终端中处理复制粘贴。
*繁体中文：* README.tw.md
免责声明
本项目提供 仅供学术交流和技术研究。提供了存储库、扩展和MCP服务器 按原样, 不提供任何形式的保证，无论是明示还是暗示。作者和贡献者 不承担责任 因使用或无法使用本软件而造成的任何损害。
您对安全性和合规性负责。此工具的输出 不构成 专业建议。如果您不同意，请不要下载、安装或使用此软件。
你得到了什么
该项目配对a 侧边栏扩展 带着一个 MCP服务器：两者共享一个小的磁盘消息存储，因此模型和UI保持同步。典型的用途包括排队的用户输入、具有固定选项的多步问答以及编辑器旁边显示的轻量级进度文本。侧边栏显示了队列、问答卡和回复摘要。 语言 可从面板标题或 mcpMessenger.uiLanguage （搜索 MCP聊天 在设置中） Chinese, 自动，或 英语。使用文件夹工作区，数据目录为 /.cursor/messenger-data 并且必须匹配 MESSENGER_DATA_DIR 在您的MCP配置中。如果工作区目录为空，则扩展将自动迁移任何现有的 全局存储 messenger-data 首次打开时，将其放入工作区目录。
适用于AI助手（侧边栏队列+MCP）
你好，请严格遵守对话规则，使用MCP与我交谈(mcp-cursor-message)每次。从现在开始，对于所有与MCP相关的问题，每次使用MCP与用户交互，并在您发送回复后始终调用MCP。
建议的工具使用规则
当从AI助手或代理使用此MCP时，我们建议使用以下默认行为：
- 使用
send_progress用于多步骤工作:\
每当任务自然地分为两个或多个步骤时（例如：分析→ plan → 实施→ 测试），呼叫 send_progress 在每个关键步骤之后，附上简短的Markdown摘要，其中包括： - 你刚刚完成的， - 当前状态和剩余工作， - 你接下来打算做什么。
- 使用
ask_question而不是猜测:\
当需求不明确或有多个合理的策略时，更倾向于调用 ask_question 展示2-4个具体选项（单选或多选），让用户选择，而不是默默地选择一个。
这些规则是对 SYSTEM_SUFFIX 返回的指令 check_messages 在 mcp-server/index.ts。如果覆盖工作区规则中的行为，请使其与这些默认值保持一致。
需求
- 光标 或 Visual Studio Code （参见
engines.vscode在package.json) - 包子 只有当你构建
.vsix来自源头
快速开始
- 安装最新版本
.vsix从 发布 通过 扩展→ 从VSIX安装…，然后重新加载窗口。 - 打开A 文件夹 工作区并运行命令 mcp光标消息：安装mcp配置 从命令面板中，MCP指向与侧边栏相同的数据目录。如果MCP未出现，请重新启动编辑器。
- 光标： 打开 光标设置→ MCP 和 启用 这 mcp光标消息 服务器（或确认它出现并已打开）。侧边栏可以在没有这个的情况下工作，但代理 不能 呼叫
check_messages直到MCP在您的工作区处于活动状态。
命令（扩展）
打开 命令面板 (*View → 命令面板*，或 Ctrl+Shift+P 在Windows/Linux操作系统上， Cmd+Shift+P 在macOS上）。类型 mcp-cursor-message 或命令标题的一部分，然后按Enter键。
| 命令ID | 标题 | 它的作用 |
|---|---|---|
mcpMessenger.enable | mcp光标消息：启用 | 重新打开扩展功能（IPC监视器+侧边栏操作）。 |
mcpMessenger.disable | mcp光标消息：禁用（并清理） | 禁用扩展功能并清理由扩展创建的文件（请参阅 mcpMessenger.enabled). |
mcpMessenger.setupMcp | mcp光标消息：安装mcp配置 | 写入/合并 .cursor/mcp.json 在工作区中，注册MCP服务器，并设置 MESSENGER_DATA_DIR 以匹配侧边栏数据文件夹。需要a 文件夹 工作空间。 |
mcpMessenger.removeMcp | mcp光标消息：删除mcp配置 | 从中删除此扩展的MCP条目 .cursor/mcp.json （不会删除整个文件）。 |
mcpMessenger.checkForUpdates | mcp游标消息：检查更新（GitHub） | 手动检查GitHub版本以获取更新的VSIX（荣誉 mcpMessenger.updateCheck.* 设置）。 |
*本节的繁体中文版本：* README.tw.md
MCP服务器工具
这些是 不 命令选项板条目。这 AI 代理 调用它们时 光标 （或另一个MCP客户端）具有 mcp光标消息 服务器已启用。
启用服务器 光标设置→ MCP模型从代理工具列表中按名称调用工具；参数在中定义 mcp-server/index.ts (registerTool).
| 工具 | 摘要 |
|---|---|
check_messages | 可选 reply （Markdown）被推到侧边栏。 积木 直到侧边栏队列传递消息或等待超时。在典型的流程中，这应该是 最后 结束转弯前呼叫MCP。 |
send_progress | 必填项 progress （Markdown）。 非阻塞；更新侧边栏进度行。 |
ask_question | 必填项 questions. 积木 直到用户在侧边栏中回答（单选/多选和可选自由文本）。 |
*繁体中文版：* README.tw.md
设置
所有钥匙都放在下面 mcpMessenger 前缀。在编辑器中： 设置 → 搜索 MCP聊天，或编辑 用户/工作区 settings.json 手动。
| 设置 | 类型 | 默认值 | 它的作用 | |||
|---|---|---|---|---|---|---|
mcpMessenger.enabled | 布尔值 | true | 侧边栏+IPC的主开关。当设置为 错误的，扩展程序停止监视IPC文件 清理干净 由扩展名创建的文件： /.cursor/messenger-data/* （包括 paste/), /.cursor/rules/{must-call-check-messages.mdc, three-phase-workflow.mdc}，以及此扩展的条目 /.cursor/mcp.json. | |||
mcpMessenger.uiLanguage | en | zh | auto | en | 侧边栏Webview语言。 auto 遵循编辑器UI语言（非英语→ 中文用户界面）。 | |
mcpMessenger.updateCheck.enabled | 布尔值 | true | 何时 false，不运行更新检查（后台或命令面板），也没有GitHub请求。 | |||
mcpMessenger.updateCheck.intervalHours | 数量（≥1） | 12 | 自动更新检查之间的时间间隔。 | |||
mcpMessenger.updateCheck.startupDelaySeconds | 数字（≥0） | 15 | 启动后等待的秒数 第一 检查； 0 马上跑。 | |||
mcpMessenger.updateCheck.repo | 字符串 | 911218sky/mcp-cursor-message | GitHub仓库 owner/name 用于放行检查的表格。 | |||
mcpMessenger.updateCheck.versionCompare | patch | minor | major | off | minor | “较新” 始终使用完整 少校。未成年人。补丁 对比 releases/latest. patch =任何较新标签的背景通知； minor （默认）=仅 次要的 或 主要的 颠簸（跳过 仅补丁); major = 主要的 只有颠簸； off =无检查。 手册 “检查更新” 忽略 补丁/次要/主要过滤器（在以下情况下仍被堵塞 off 或 enabled: false).传统价值观 full 和 majorMinor 地图到 patch 和 minor. |
{
"mcpMessenger.uiLanguage": "auto",
"mcpMessenger.updateCheck.enabled": true,
"mcpMessenger.updateCheck.versionCompare": "minor",
"mcpMessenger.updateCheck.repo": "911218sky/mcp-cursor-message"
}*繁体中文设置指南：* README.tw.md
从源代码安装
克隆存储库，安装依赖项 包子，构建扩展包，然后安装生成的 .vsix 与发布版本相同：
git clone https://github.com/911218sky/mcp-cursor-message.git
cd mcp-cursor-message
bun install
bun run packageVSIX被写入存储库根目录（例如 mcp-cursor-message-9.2.0.vsix，版本从 package.json).
故障排除
- Webview加载失败 （包括与Service Worker相关的消息）：通常是嵌入式Chromium中的一类已知问题；尝试关闭所有窗口并重新打开，或更新Cursor。看 microsoft/vcode#125993.
- MCP未出现 /工具从不运行：确认您运行了 mcp光标消息：安装mcp配置 并重新启动；在 光标设置→ MCP，启用服务器；检查
.cursor/mcp.json获取正确的服务器命令MESSENGER_DATA_DIR.
贡献和内部
贡献者工作流程、IPC合同和版本控制已上线 代理商.md 和 项目.md.