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 瞭解開發設置和指南。