MCP Cursor Message

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 来自源头

快速开始

1. 安装最新版本 .vsix 从 发布 通过 扩展→ 从VSIX安装…，然后重新加载窗口。
2. 打开A 文件夹 工作区并运行命令 mcp光标消息：安装mcp配置 从命令面板中，MCP指向与侧边栏相同的数据目录。如果MCP未出现，请重新启动编辑器。
3. 光标： 打开 光标设置→ MCP 和 启用 这 mcp光标消息 服务器（或确认它出现并已打开）。侧边栏可以在没有这个的情况下工作，但代理 不能 呼叫 check_messages 直到MCP在您的工作区处于活动状态。

命令（扩展）

打开 命令面板 (*View → 命令面板*，或 Ctrl+Shift+P 在Windows/Linux操作系统上， Cmd+Shift+P 在macOS上）。类型 mcp-cursor-message 或命令标题的一部分，然后按Enter键。

*本节的繁体中文版本：* README.tw.md

MCP服务器工具

这些是 不 命令选项板条目。这 AI 代理 调用它们时 光标 （或另一个MCP客户端）具有 mcp光标消息 服务器已启用。

启用服务器 光标设置→ MCP模型从代理工具列表中按名称调用工具；参数在中定义 mcp-server/index.ts (registerTool).

*繁体中文版：* README.tw.md

设置

所有钥匙都放在下面 mcpMessenger 前缀。在编辑器中： 设置 → 搜索 MCP聊天，或编辑 用户/工作区 settings.json 手动。

{
  "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 package

VSIX被写入存储库根目录（例如 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.

许可证

AGPL-3.0