Memories With Lessons

🚀 MCP 內存服務器指南

MCP 內存服務器是一款強大的工具，它提供知識圖譜管理和錯誤處理與課程管理等功能，能有效幫助用戶實現智能記憶和課程管理，提升工作效率。

🚀 快速開始

環境配置

1. 默認設置：
   • 內存文件路徑：memory.json（位於服務器目錄）。
2. 自定義配置：
   • 通過環境變量 MEMORY_FILE_PATH 設置自定義路徑，例如："MEMORY_FILE_PATH": "/path/to/custom/memory.json"

安裝與運行

• Docker 方式：

docker build -t mcp/memory -f src/memory/Dockerfile .

• NPX 方式：

{
    "mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-memory"
            ],
            "env": {
                "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
            }
        }
    }
}

集成到工具

• Claude Desktop：
  • 在 claude_desktop_config.json 中添加 MCP 服務器配置。
  • 示例：

{
    "mcpServers": {
        "memory": {
            "command": "docker",
            "args": ["run", "-i", "-v", "claude-memory:/app/dist", "--rm", "mcp/memory"]
        }
    }
}

✨ 主要特性

知識圖譜管理

• 知識圖譜：通過構建和操作知識圖譜實現智能記憶功能。
• 核心操作：
  • 創建實體：新增節點，支持自定義屬性和值。
  • 添加關係：定義兩個實體之間的關聯，包括類型和方向。
  • 記錄觀察：存儲事實或描述信息作為觀察數據。

錯誤處理與課程管理

• 新建課程：基於錯誤及其解決方案創建課程條目。
• 相似錯誤查找：通過錯誤模式識別匹配的課程。
• 更新課程狀態：根據解決方案的有效性調整課程記錄。
• 推薦課程：依據上下文提供相關課程建議。

📦 安裝指南

環境配置

1. 默認設置：
   • 內存文件路徑：memory.json（位於服務器目錄）。
2. 自定義配置：
   • 通過環境變量 MEMORY_FILE_PATH 設置自定義路徑，例如："MEMORY_FILE_PATH": "/path/to/custom/memory.json"

安裝與運行

• Docker 方式：

docker build -t mcp/memory -f src/memory/Dockerfile .

• NPX 方式：

{
    "mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-memory"
            ],
            "env": {
                "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
            }
        }
    }
}

集成到工具

• Claude Desktop：
  • 在 claude_desktop_config.json 中添加 MCP 服務器配置。
  • 示例：

{
    "mcpServers": {
        "memory": {
            "command": "docker",
            "args": ["run", "-i", "-v", "claude-memory:/app/dist", "--rm", "mcp/memory"]
        }
    }
}

💻 使用示例

基礎用法

環境配置

{
    "mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-memory"
            ],
            "env": {
                "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
            }
        }
    }
}

高級用法

集成到 Claude Desktop

{
    "mcpServers": {
        "memory": {
            "command": "docker",
            "args": ["run", "-i", "-v", "claude-memory:/app/dist", "--rm", "mcp/memory"]
        }
    }
}

📚 詳細文檔

新增功能

創建課程

• 輸入：lesson 對象，包含錯誤模式、解決方案步驟和元數據。
• 自動跟蹤：記錄創建時間和更新狀態。
• 驗證：確保所有解決方案步驟完整。

尋找相似錯誤

• 輸入：errorPattern 對象，包括錯誤類型、消息和上下文。
• 輸出：按成功率排序的匹配課程列表。
• 包含內容：相關解決方案和驗證步驟。

更新課程狀態

• 輸入：
  • lessonName（字符串）：指定要更新的課程名稱。
  • success（布爾值）：指示解決方案是否有效。
• 更新指標：調整成功率和發生頻率數據。

獲取課程推薦

• 輸入：上下文信息（字符串）。
• 輸出：按相關性和成功率排序的課程列表。
• 包含內容：完整的解決方案細節和驗證步驟。

📄 許可證

此 MCP 服務器遵循 MIT 許可證，允許自由使用、修改和分發軟件，具體條款請參考項目倉庫中的 LICENSE 文件。

致謝

感謝原項目倉庫（https://github.com/modelcontextprotocol/servers）的所有貢獻者，特別是 jerome3o - anthropic 為知識圖譜功能奠定了基礎。在此基礎上，我們新增了課程管理和錯誤處理功能，並完善了文件管理機制。