Live Memory MCP 服务器

关键词

Memory BankGraph Memory BridgeS3 storageLLM orchestration多代理协作

使用说明（Markdown 格式）

  • 项目简介

    • Live Memory 是一个完整的 MCP 服务器实现，提供资源管理、工具执行、提示模板等能力，并通过 MCP Streamable HTTP 协议与 LLM 客户端通信。服务器内置认证、并发锁、S3 存储、对接 Graph Memory 的桥接等组件，适合在多代理场景下共享工作记忆与协作。

  • 主要功能点

    • 资源与空间管理：创建、列出、查看空间信息与规则（space_* 系列工具与服务）
    • Live Notes 与 Bank：实时笔记写入、读取与基于 LLM 的银行化整理（bank_consolidate）及导出
    • 图谱桥接：将银行内容推送到 Graph Memory，支持连接、推送、状态与断开
    • 权限与认证：Bearer Token、admin bootstrap、多级权限（read/write/admin），并发访问控制
    • 数据存储与备份：S3 存储、备份创建/列表/导出/删除
    • REST/前端接口与接口网关：静态文件服务、/live 界面、/api 接口
    • 客户端支持：提供基于 Streamable HTTP 的 MCP 客户端示例（脚本/cli 与 JS API）
    • CLI 与测试脚本：提供完整的测试 recettes 与质量测试用例
    • 安全性与监控：WAF、Bearer 认证、日志中间件、健康检查

  • 安装步骤

    1. 克隆仓库并进入项目
    2. 按 README 中的 prerequisites 设置环境依赖（Docker、Docker Compose、Python 3.11+ 等）
    3. 使用 Docker Compose 启动服务（推荐）：
      • docker compose build
      • docker compose up -d
      • 查看状态：docker compose ps
      • 健康检查：curl -s http://localhost:8080/health
    4. 也可本地开发模式运行（直接运行 Python 服务）
      • 安装依赖：pip install -r requirements.txt
      • 启动服务：cd src && python -m live_mem
    5. 根据 .env/.env.example 配置 S3、LLMaaS 等参数
    6. 访问界面与 API：
      • 界面：http://localhost:8080/live
      • MCP 服务入口：http://localhost:8002/mcp
    7. 运行 MCP 客户端示例与脚本进行交互（见下方“服务器配置”中的示例）

  • 服务器配置（MCP 客户端使用信息，JSON 格式） 注意：MCP 客户端需要通过服务器提供的启动命令与参数来建立连接。下面给出一个可直接用于客户端配置的示例 JSON，字段含义与仓库实现一致： { "server_name": "Live Memory", "command": "python -m live_mem", "args": [], "host": "0.0.0.0", "port": 8002, "notes": "启动 Live Memory MCP 服务器（默认使用 /mcp 端点，端口由环境变量或配置决定）", "env": { "S3_ENDPOINT_URL": "<你的 S3 端点>", "S3_ACCESS_KEY_ID": "<你的 Access Key>", "S3_SECRET_ACCESS_KEY": "<你的 Secret Key>", "S3_BUCKET_NAME": "<你的桶名>", "S3_REGION_NAME": "<区域>", "ADMIN_BOOTSTRAP_KEY": "<引导管理密钥>", "LLMAAS_API_URL": "<LLMaaS APIUrl，例如 https://api.llmaaS /v1>", "LLMAAS_API_KEY": "<LLMaaS API Key>", "LLMAAS_MODEL": "<LLM 模型标识，例如 qwen3-2507:235b>" } } 说明：

    • server_name: MCP 服务器的标识名称，客户端用于展示与识别
    • command/args: 运行服务器的命令及参数，示例中使用 python -m live_mem
    • host/port: 监听地址与端口，默认监听 0.0.0.0:8002（与 README 配置一致）
    • env: 运行所需的外部依赖配置，包含 S3、LLMaaS、引导密钥等
    • 以上配置可按实际部署环境进行调整，MCP 客户端不需要额外代码即可使用此配置与服务器建立连接

服务器信息

访问项目