Memory Bank MCP

🚀 內存銀行

內存銀行是一款用於管理和維護項目上下文的系統。它藉助標準化結構來組織信息，讓人工智能助手能夠便捷地訪問和更新這些信息，極大提升了項目管理的效率和智能性。

🚀 快速開始

作為命令行工具

# 初始化內存銀行
memory-bank-mcp initialize_memory_bank path=./memory-bank

# 跟蹤進度
memory-bank-mcp track_progress action="功能實現" description="實現了功能X"

# 記錄決策
memory-bank-mcp log_decision title="API設計" context="..." decision="..."

# 切換模式
memory-bank-mcp switch_mode mode=代碼

作為庫

import { MemoryBankServer } from "@movibe/memory-bank-mcp";

// 創建一個新的服務器實例
const server = new MemoryBankServer();

// 啟動服務器
server.start();

✨ 主要特性

核心功能

• 初始化：通過調用 memory-bank-mcp initialize_memory_bank 命令創建新的內存銀行。
• 跟蹤進度：使用 track_progress 工具記錄項目進展。
• 記錄決策：通過 log_decision 工具記錄重要決策及其背景信息。
• 切換模式：根據需要切換不同的操作模式，如代碼模式或問題解決模式。

數據流

1. 初始化：人工智能助手連接到內存銀行服務器並初始化內存銀行。
2. 工具調用：人工智能助手通過內存銀行服務器提供的工具讀取和寫入內存銀行文件。
3. 上下文維護：內存銀行保持上下文信息，使人工智能能夠回憶之前做出的決策和進度。

結構特點

內存銀行採用標準化結構組織信息：

• 產品背景：包括項目概述、目標、所用技術和架構。
• 當前狀態：記錄當前項目的狀態、正在進行的任務、已知問題及下一步操作。
• 進展歷史：按時間順序記錄項目更新和里程碑。
• 決策日誌：記錄重要決策及其背景、替代方案和後果。
• 系統模式：包含項目的架構模式、代碼模式和文檔模式。

高級功能

• UMB命令：在會話期間臨時更新內存銀行文件，但不提交更改。
• 模式檢測：根據用戶輸入自動檢測並切換模式。
• 文件遷移工具：用於在不同文件命名約定之間進行遷移。
• 語言標準化：所有內存銀行文件均以英語生成，確保一致性。

📚 詳細文檔

版本控制

該項目遵循語義化版本控制和約定提交法。版本號規則如下：

• 主要版本號：當有破壞性更改時（如提交消息中標記 BREAKING CHANGE 或 !:）。
• 次要版本號：當添加新功能時（如提交消息中標記 feat: 或 feat(scope):）。
• 補丁版本號：其他所有變更（如錯誤修復、文檔更新等）。

完整的變更歷史記錄在 CHANGELOG.md 文件中。

內存銀行狀態系統

狀態代碼說明

• IDLE：表示服務器處於空閒狀態。
• BUSY：表示服務器正在處理請求。
• ERROR：表示服務器遇到錯誤。

狀態查詢命令

# 查詢當前狀態
memory-bank-mcp get_status

其他資源

• 項目文檔
• 問題提交

📄 許可證

該項目使用 MIT 許可證，具體內容如下：

MIT License
版權所有 (c) 2024, 作者姓名
允許自由使用、修改和分發此軟件，前提是保留版權聲明。

如需進一步瞭解內存銀行，請訪問 項目主頁。