Continuo Memory MCP

🚀 連續內存系統

連續內存系統是一個為開發環境提供持久化存儲和分層壓縮功能的系統，它能有效解決開發流程中的知識存儲和檢索問題，突破上下文窗口限制，提升開發效率。

🚀 快速開始

📦 安裝指南

git clone https://github.com/GtOkAi/continuo-memory-mcp-memory-mcp.git
cd continuo
./scripts/setup_memory.sh

💻 使用示例

基礎用法

1. 啟動內存服務器：

./scripts/run_memory_server.sh

2. 配置你的IDE（Qoder/Cursor）： 創建 .qoder/mcp.json（或 .cursor/mcp.json）：

{
  "mcpServers": {
    "continuo-memory": {
      "command": "/absolute/path/to/continuo/venv_memory/bin/python",
      "args": [
        "/absolute/path/to/continuo/src/mcp/memory/mcp_memory_server.py",
        "--provider",
        "local",
        "--db-path",
        "/absolute/path/to/memory_db"
      ]
    }
  }
}

3. 在你的IDE中使用：

@continuo-memory search_memory("authentication implementation")
@continuo-memory store_memory("Fixed JWT validation bug", {"file": "auth.py"})
@continuo-memory get_memory_stats()

✨ 主要特性

• 持久內存：跨會話存儲和檢索開發知識。
• 語義搜索：使用自然語言查詢查找相關信息。
• 分層壓縮：N0（數據塊）→ N1（摘要）→ N2（元摘要）。
• MCP集成：通過模型上下文協議與IDE無縫集成。
• 成本效益高：提供100%本地（免費）或混合（低成本）部署選項。
• FastMCP：基於現代MCP服務器框架構建。

📚 詳細文檔

架構

IDE Chat ──► MCP Adapter ──► Memory Server ──► ChromaDB
      ▲              ▲                 │            │
      │              └──── tools ◄─────┘            │
      └───── response ◄──── context ◄───────────────┘

組件

• 內存服務器：使用ChromaDB和sentence-transformers進行嵌入。
• MCP適配器：FastMCP服務器，提供 search_memory 和 store_memory 工具。
• 分層壓縮：多級上下文優化（N0/N1/N2）。
• 自主模式：可選的自動化，具有觀察 → 計劃 → 行動 → 反思循環。

配置

本地嵌入（免費）

python src/mcp/memory/mcp_memory_server.py \
  --provider local \
  --db-path ./memory_db

OpenAI嵌入（低成本）

python src/mcp/memory/mcp_memory_server.py \
  --provider openai \
  --api-key sk-your-key \
  --db-path ./memory_db

API

工具

• search_memory(query: str, top_k: int = 5, level: str | None = None) -> str：在持久內存中進行語義搜索，返回帶有相似度分數的相關文檔。
• store_memory(text: str, metadata: dict | None = None, level: str = "N0") -> str：將內容存儲在持久內存中，支持元數據標記和分層級別。
• get_memory_stats() -> str：獲取內存統計信息（總文檔數、級別等）。

分層級別

• N0：原始數據塊（代碼片段、對話）。
• N1：微摘要（壓縮5 - 10個數據塊）。
• N2：元摘要（壓縮5 - 10個摘要）。

示例

請參閱 [examples/memory/](examples/memory/) 目錄：

• basic_usage.py：簡單的存儲/檢索操作。
• hierarchical_demo.py：多級壓縮示例。
• auto_mode_demo.py：自主模式演示。

文檔鏈接

• 設置指南：詳細的安裝說明。
• 架構規範：完整的技術文檔。
• 行為準則：社區指南。

🔧 技術細節

技術棧

• Python 3.9+：核心實現語言。
• ChromaDB：用於嵌入的向量數據庫。
• Sentence Transformers：本地嵌入生成（all-MiniLM-L6-v2）。
• FastMCP：MCP服務器框架。
• 模型上下文協議：IDE集成標準。

成本與許可

嵌入提供商

軟件許可

詳細信息請參閱 COMMERCIAL_LICENSE.md。

📄 許可證

連續內存系統採用雙重許可：

📖 開源（AGPL v3）

免費適用於：

• ✅ 個人開發者和研究人員。
• ✅ 非營利組織和教育機構。
• ✅ 年收入 <$1M 且員工 <10 的公司。
• ✅ 開發、測試和評估。
• ✅ 開源項目（與AGPL兼容）。

要求：根據AGPL v3共享修改後的源代碼。

完整的AGPL v3條款請參閱 LICENSE。

💼 商業許可證

適用於：

• ❌ 年收入 ≥$1M 或 員工 ≥10 的公司。
• ❌ 專有/閉源產品。
• ❌ 不公開源代碼的SaaS服務。

優勢：

• ✅ 無AGPL版權共享義務。
• ✅ 專有使用權。
• ✅ 優先支持（可選）。
• ✅ 自定義部署協助（可選）。

定價：從 $2,500/年（青銅版）到定製企業版。

定價和詳細信息請參閱 COMMERCIAL_LICENSE.md。

💡 為什麼選擇AGPL + 商業許可？

• 可持續發展：商業用戶資助持續維護。
• 開源保護：AGPL防止專有分支。
• 公平使用：小團隊和非營利組織可永久免費使用。
• 社區優先：核心功能始終開源。

商業諮詢請聯繫：gustavo@shigoto.me

致謝

本項目使用了以下技術：

• 模型上下文協議 - 協議規範。
• MCP Python SDK - MCP實現。
• ChromaDB - 向量數據庫。
• Sentence Transformers - 嵌入模型。

作者

• D.D. & Gustavo Porto

注意：本項目實現了 continuo.markdown 中描述的架構。有關學術背景和詳細規範，請參考該文檔。