Mode Manager MCP

🚀 GitHub Copilot Memory Tool

GitHub Copilot Memory Tool 为 GitHub Copilot 赋予持久记忆能力，让它在各种对话场景中都能记住你的偏好和上下文信息，极大提升使用效率和代码生成质量。

🚀 快速开始

如果你还没有安装 python，需要先从 python.org/downloads 进行安装。

1. 从 PyPI 安装 pipx

pip install pipx

2. 点击对应 VS Code 的徽章进行安装

.. 或者手动添加到你的 VS Code

将以下内容添加到你的 VS Code MCP 设置 (mcp.json) 中：

{
  "servers": {
    "mode-manager": {
      "command": "pipx",
      "args": [
        "run",
        "mode-manager-mcp"
      ]
    }
  }
}

完成以上步骤后，就可以开始与 Copilot 聊天并使用 "Remember that..." 指令了。

额外福利

为了方便使用，你可以在 VS Code 中运行以下提示来开启最佳使用体验：

/mcp.mode-manager.onboarding

这将引导你完成入门流程，设置持久记忆，并确保 Copilot 从一开始就了解你的偏好。

给等不及下一个版本的勇敢者

如果你将以下内容添加到 mcp.json 中，pipx 每次都会直接从 GitHub 下载并安装最新版本：

{
  "servers": {
    "mode-manager": {
      "command": "pipx",
      "args": [
        "run",
        "--no-cache",
        "--system-site-packages",
        "--spec",
        "git+https://github.com/NiclasOlofsson/mode-manager-mcp.git",
        "mode-manager-mcp"
      ]
    }
  }
}

✨ 主要特性

2025 年的变革性工具

该工具专为 VS Code 的新特性打造，每次聊天消息都会加载自定义指令，使得持久记忆功能变得极其强大，无论讨论何种话题，记忆始终有效。

• 记忆始终活跃：在每一次对话、每一轮交流中，你的记忆信息都能发挥作用。
• 无需重复上下文：开启新聊天时，无需再次重复之前的上下文信息。
• 跨会话、话题和项目了解你：Copilot 能够在不同会话、话题和项目中真正了解你的需求。
• 时机恰到好处：专为新的指令加载行为而设计。

简单易用

只需一个命令即可完成所有操作：

Ask Copilot: "Remember that I prefer detailed docstrings and use pytest for testing"

这样，Copilot 就会永远记住这些信息，并在未来的所有对话中应用。

记忆内容丰富

• 工作上下文：你的角色、所在公司、当前项目等。
• 编码偏好：编程语言、框架、风格指南等。
• 项目细节：架构决策、命名约定等。
• 个人工作流程：你喜欢的工作方式、调试和测试方法等。

幕后工作原理

1. 自动设置：首次使用时，会在 VS Code 提示目录中创建 memory.instructions.md 文件。
2. 智能存储：每条记忆都会添加时间戳并进行组织。
3. 始终加载：VS Code 2025 年的新特性确保你的记忆会包含在每个聊天请求中。
4. 跨会话持久化：即使重启 VS Code 或开启新对话，你的记忆依然存在。

额外功能

除了记忆功能，该工具还能管理你的 VS Code 提示生态系统：

• 精选库：提供 20 多种专业聊天模式和指令。
• 文件管理：可以创建、编辑和组织 .chatmode.md 和 .instructions.md 文件。
• 保持更新：从源更新文件的同时保留你的自定义设置。

💻 使用示例

基础用法

在使用该工具之前：

你: "Hey Copilot, write me a Python function..."
Copilot: 给出通用的 Python 代码

使用 remember 之后：

你: "Remember I'm a senior data architect at Oatly, prefer type hints, and use Black formatting"
下一次对话: "Write me a Python function..."
Copilot: 生成带有类型提示、符合你精确偏好的完美风格代码

高级用法

你可以让 Copilot 记住更多详细信息，例如：

Ask Copilot: "Remember that I prefer detailed docstrings and use pytest for testing"

这样，Copilot 就会在后续的对话中始终遵循这些偏好。

🔧 技术细节

该工具在首次使用时会自动在 VS Code 提示目录中创建 memory.instructions.md 文件，用于存储记忆信息。每条记忆都会添加时间戳并进行组织，以确保信息的有序性和可追溯性。VS Code 2025 年的新特性使得这些记忆信息会包含在每个聊天请求中，从而实现跨会话的持久化。此外，该工具还提供了文件管理和更新功能，方便用户管理和维护自己的提示生态系统。

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

贡献代码

如果你想帮助改进这个工具，请查看 CONTRIBUTING.md 了解开发设置和指南。