Advanced Memory MCP

关键词

模型上下文工具注册资源管理JSON-RPC桥接服务

使用说明

  • 项目简介

    • Advanced Memory MCP 是一个企业级的模型上下文协议(MCP)服务器，核心职责是以标准化方式向LLM客户端提供上下文信息和功能，包括资源（如笔记、数据等）的托管与访问、可注册与执行的工具、以及可定制的Prompt模板。服务器通过JSON-RPC与客户端通信，具备会话管理、能力声明，并可通过多种传输协议与前端/桥接服务协作。
    • 该仓库还提供一个基于Node的桥接服务器，能够把STDIO形式的MCP通讯转换为HTTP/WS等前端友好接口，配合一个React前端Web应用实现知识管理、RAG检索、以及技能编排等功能。

  • 主要功能点

    • 资源(Resource)管理：对笔记、文档等内容进行创建、读取、更新和删除，支持元数据和标签等维度。
    • 工具(Tools)注册与调用：包含大量“adn_*”前缀的工具，可对外部系统发起操作、数据检索、文档处理、导入导出等。
    • 提示模板(Prompts)定义与获取：为LLM交互提供上下文系统提示和模板化对话流。
    • MCP协议实现：完整的JSON-RPC格式请求/响应处理、请求ID跟踪、错误/异常处理，以及初始化阶段的能力自发现。
    • 会话与能力管理：维护客户端会话、可用工具、可用提示等能力信息，确保后续调用的可用性。
    • 多传输协议支持与桥接：内置FastMCP风格的接入模式，附带桥接服务器（bridge-server.js）实现从stdio到HTTP的转换，便于Web前端/Bridge客户端访问。
    • 生产就绪的生态：包括测试覆盖、CLI/脚本入口、以及Web前端集成方案。

  • 安装与运行步骤（简要）

    • 依赖与环境
      • Python 3.11+、Node.js（用于Web前端和桥接服务）以及相应的MCP客户端。
    • 安装
      • 使用Python包安装（开发环境）：执行本仓库根目录的安装流程（包含MCP服务端代码）。另外，需要安装前端依赖以运行Web界面。
    • 启动
      • 推荐方式：使用 uvx 命令启动 Advanced Memory MCP（如 README 所述的 Quick Start），以便同时启动服务器及其Web前端桥接与后台组件。
      • 备选方式：直接通过提供的启动脚本运行，例如运行 Python 模块方式启动MCP服务器，通过 HTTP/Streamable-HTTP等传输协议对外提供服务。
    • 配置（MCP客户端所需的服务器启动信息，示例为JSON格式，请按实际环境替换路径）
      • server name: advanced-memory
      • command: uv
      • args: ["--directory", "/path/to/advanced-memory-mcp", "run", "advanced-memory"] 注释：该配置用于MCP客户端按需启动并连接到指定MCP服务器实例。客户端本身不需要知道内部实现细节，只需通过该命令及参数来启动服务器。请使用真实的目录路径替换示例中的路径。

  • 基本使用方法

    • 启动与连接
      • 通过快速启动命令 uvx advanced-memory 即可启动MCP服务器及相关前端桥接与应用。
      • 也可在本地直接运行提供的脚本（如 run_server.py/桥接服务）以指定端口和传输模式进行调试。
    • 客户端接入
      • 使用支持的MCP客户端（Cursor、Claude Desktop、WebBridge等）连接到 MCP 服务器端点，开始读取资源、调用工具、以及获取Prompt。
    • 常见操作
      • 读取资源、执行工具、获取Prompts、以及通过桥接服务器对前端进行实时交互。
      • Web界面通过桥接服务器实现对MCP能力的直观管理与RAG工作流的编排。

  • 注意事项

    • MCP服务器是对外服务端，客户端需要通过配置正确的启动命令及参数来连接。
    • 根据实际部署环境，端口、目录结构、以及桥接服务的配置可能不同，请参考仓库根目录下的文档与脚本进行相应调整。

服务器信息

访问项目