Simple Memory Extension MCP Server

🚀 簡單內存擴展 MCP 服務器

本項目是一個用於擴展代理上下文窗口/記憶的 MCP 服務器。在編碼大型功能或進行氛圍編碼（vibe coding）時極為實用，它能夠存儲/檢索進度、關鍵時刻、更改或其他任何值得記錄的內容。你只需讓代理存儲記憶，並在需要時進行檢索，也可以讓代理自行管理其記憶（例如通過遊標規則等方式）。

🚀 快速開始

啟動服務器

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. 返回頂部匹配項及其完整項目值

💻 使用示例

基礎用法

# 啟動服務器
npm install
npm start

高級用法

# 開發服務器
npm run dev

# 格式化代碼
npm run format

📚 詳細文檔

.env 配置

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

PORT=3000

# 使用 HTTP SSE 或標準輸入輸出
USE_HTTP_SSE=true

# 日誌級別：debug, info, warn, error
LOG_LEVEL=info

語義搜索說明

該項目包含使用 Hugging Face 的 E5 嵌入模型實現的語義搜索功能。這使得你可以根據上下文項的含義而不是精確鍵匹配來查找內容。

設置

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

嵌入模型

我們使用 intfloat/multilingual-e5-large-instruct 模型