Simple Memory Extension

🚀 簡單內存擴展 MCP 服務器

簡單內存擴展 MCP 服務器用於擴展代理上下文窗口和記憶。在開發大型功能或進行 vibe 編碼時，它能幫助存儲和召回進度、關鍵時刻、更改等重要內容。你可以讓代理存儲記憶、隨時召回，也能讓代理通過遊標規則等自主管理記憶。

🚀 快速開始

啟動服務器

npm install
npm start

✨ 主要特性

可用工具

上下文項管理

• store_context_item - 在命名空間中存儲值和鍵
• retrieve_context_item_by_key - 根據鍵獲取值
• delete_context_item - 刪除鍵值對

命名空間管理

• create_namespace - 創建新命名空間
• delete_namespace - 刪除命名空間及其所有內容
• list_namespaces - 列出所有命名空間
• list_context_item_keys - 在命名空間中列出鍵

語義搜索

• retrieve_context_items_by_semantic_search - 根據意義查找項

語義搜索實現

1. 使用 E5 模型將查詢轉換為向量
2. 自動將文本拆分為段落以提高匹配效果
3. 計算查詢與存儲段落之間的餘弦相似度
4. 根據閾值過濾結果並按相似度排序
5. 返回 top 匹配項及其完整值

💻 使用示例

基礎用法

# 啟動服務器
npm install
npm start

高級用法

# 開發服務器
npm run dev

# 格式化代碼
npm run format

📚 詳細文檔

.env 配置

# SQLite 數據庫文件路徑
DB_PATH=./data/context.db

PORT=3000

# 使用 HTTP SSE 或 Stdio
USE_HTTP_SSE=true

# 日誌配置：debug, info, warn, error
LOG_LEVEL=info

語義搜索

該項目包含使用 Hugging Face 的 E5 嵌入模型的語義搜索功能。這使你可以根據項的意義而不是僅通過鍵來查找上下文項。

設置

語義搜索功能需要 Python 依賴，但這些應該在運行 npm run start 時自動安裝。

嵌入模型

我們使用的是 intfloat/multilingual-e5-large-instruct

備註

此項目主要是在 vibe 編碼過程中開發的，所以不要期望太多 :D。但它確實有效，我覺得它很有用，隨意貢獻或提供建議。