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 中描述的架构。有关学术背景和详细规范，请参考该文档。