Memory MCP

🚀 記憶 MCP 服務器

記憶 MCP 服務器是一個基於模型上下文協議（Model Context Protocol）的服務器，它藉助低級服務實現和 SQLite 存儲，來完成記憶的存儲與檢索工作。

🚀 快速開始

啟動 MCP 服務器，即可開始存儲和檢索記憶：

memory-mcp

✨ 主要特性

• 便捷的依賴管理：使用 uv 進行依賴管理，而非傳統的 pip，uv 是快速且可靠的 Python 包安裝程序和解析器。
• 豐富的工具支持：提供 remember、get_memory、list_memories、update_memory、delete_memory 等工具，滿足存儲、檢索、更新和刪除記憶等多種操作需求。
• 強大的調試功能：MCP 提供 mcp inspect 命令行工具，方便直接調試和與 MCP 服務器交互，還可啟用調試模式查看詳細的請求和響應信息。

📦 安裝指南

此項目使用 uv 進行依賴管理。如果你沒有安裝 uv，請按照 官方說明 安裝。

使用 uv 安裝

uv pip install memory-mcp

直接從源代碼安裝

uv pip install .

開發時安裝

uv pip install -e ".[dev]"

💻 使用示例

運行服務器

memory-mcp

可用工具

Memory MCP 提供以下工具：

• remember：存儲一個新的記憶，帶有標題和內容
• get_memory：通過 ID 或標題檢索特定記憶
• list_memories：列出所有存儲的記憶
• update_memory：更新現有記憶
• delete_memory：刪除一條記憶

使用 MCP 檢查進行調試

設置

1. 安裝 MCP CLI 工具：

uv pip install mcp[cli]

2. 在一個終端中啟動 Memory MCP 服務器：

memory-mcp

3. 在另一個終端中，使用 mcp inspect 連接到運行中的服務器：

mcp inspect

使用 MCP 檢查

連接後，可執行以下操作：

列出可用工具

> tools

調用工具

> call remember title="會議記錄" content="討論了項目的時間表和關鍵里程碑。"

> call list_memories

> call get_memory memory_id=1

> call update_memory memory_id=1 title="更新後的標題" content="更新後的內容。"

> call delete_memory memory_id=1

開發模式

> debug on

探索工具架構

> tool remember

故障排除

如果遇到問題：

1. 檢查正在運行服務器的終端中的服務器日誌，獲取任何錯誤信息。
2. 在 MCP 檢查終端中啟用調試模式 debug on，以查看原始請求和響應。
3. 確保工具參數與預期架構匹配（使用 tool 命令進行檢查）。
4. 如果服務器崩潰，請檢查運行服務器的終端中的任何未捕獲異常。

🔧 技術細節

開發貢獻

要為項目做出貢獻，請安裝開發依賴項：

uv pip install -e ".[dev]"

管理依賴項

此項目使用 uv.lock 文件來鎖定依賴項。要更新依賴項：

uv pip compile pyproject.toml -o uv.lock

運行測試

python -m pytest

代碼格式化

black memory_mcp tests

溶劑檢查

ruff check memory_mcp tests

類型檢查

mypy memory_mcp