LightMem MCP 服务器

关键词

内存管理LLM 工具JSON-RPC模型上下文协议LightMem

使用说明（Markdown 格式）

  • 项目简介 LightMem MCP 服务器基于 LightMem 提供的内存管理能力，实现 Model Context Protocol（MCP）的服务端。通过 FastMCP 暴露工具接口，允许 LLM 客户端通过标准的 JSON-RPC 请求读取内存、执行工具、获取/渲染 Prompt 等能力，并支持会话管理与多传输协议的扩展。

  • 主要功能点

    • MCP 协议核心能力：通过 FastMCP 暴露工具（tool）接口，处理请求并返回 JSON-RPC 响应。
    • 资源与工具管理：提供内存相关的“资源/内存条目”读取、更新、查询等操作，以及用于内存管理的工具调用。
    • 工具注册与执行：将内存相关操作封装为 MCP 工具，供客户端远程调用。
    • 示例化的服务器端实现：在 mcp/server.py 中定义了若干 MCP 工具，如 get_timestamp、add_memory、offline_update、retrieve_memory、show_lightmem_instance。
    • 参考配置与启动方式：包含 README 中的 MCP 启动与 Inspector 使用示例，便于快速接入。

  • 安装步骤

    • 安装依赖并启用 MCP 功能
      • 运行时建议通过打包方式安装：pip install '.[mcp]'，确保 fastmcp 等依赖可用。
    • 启动 MCP 服务
      • 直接运行服务器脚本：python mcp/server.py 以启动服务（读取 default 配置或通过传入的配置指定 LightMem 实例）。
      • 或使用 MCP 客户端启动命令（示例，需客户端支持）：
        • fastmcp run mcp/server.py:mcp --transport http --port 8000
    • 可选的 MCP Inspector
      • npm 包执行：npx @modelcontextprotocol/inspector
      • 命令示例：npx @modelcontextprotocol/inspector python mcp/server.py
    • 服务器配置（MCP 客户端需要，不属于 MCP 服务器本身） MCP 客户端通常需要一个 JSON 配置，指定服务器地址等信息，例如： { "yourMcpServers": { "LightMem": { "url": "http://127.0.0.1:8000/mcp", "otherParameters": "..." } } }

  • 服务器配置（客户端所需的配置信息说明，非代码）

    • server name: LightMem
    • command: 运行脚本或启动命令来部署 MCP 服务端
    • args: 运行参数（如传入的配置文件路径、端口、传输协议等） 说明：以上信息用于 MCP 客户端建立连接与调用。具体参数在仓库 README 的示例中有明确描述（如 Inspector、HTTP 传输等），请按实际环境配置。

  • 基本使用方法

    • 启动后客户端通过 MCP URL 进行请求，调用 get_timestamp、add_memory、offline_update、retrieve_memory、show_lightmem_instance 等工具。
    • 通过 Inspector 进行服务端接口可视化检查和调试。
    • 如需扩展，可在 mcp/server.py 增添新的工具并通过 @mcp.tool() 注解暴露。

  • 运行与扩展注意事项

    • 依赖需正确安装，确保 fastmcp 模块可用。
    • 服务端需要正确配置 LightMem 的配置文件（example.json），用于初始化 LightMemory 实例。
    • 如有并发访问，请确保服务端的并发配置与 LightMem 的并发能力兼容。

服务器信息

访问项目