SQLite Memory MCP Server

使用说明(简要版,便于快速上手)

  • 项目简介

    • 这是一个完整的 MCP 服务器实现,基于快速的 MCP 框架(FastMCP),使用 SQLite 作为后端存储,提供知识图谱的资源管理、工具执行、提示模板管理,以及会话跟踪、跨机器桥接与任务管理等能力,支持多会话并发访问。
  • 主要功能点(面向使用者的要点)

    • 资源与知识图谱管理:创建实体、添加观测、建立关系、执行全文检索(FTS5 BM25)。
    • 工具执行与数据访问:提供多种工具接口来读取/修改知识图谱及相关元数据。
    • 会话与记忆:会话保存、 recalls、以及跨会话连续上下文能力。
    • 任务管理:内置任务/待办管理、分组、筛选、提醒与归档等。
    • 跨机桥接:通过本地桥仓库实现跨机器的知识与任务同步。
    • 公共知识与评价:发布待审知识、对公共知识进行评分、评价与信度分析。
    • 安全与并发:使用 SQLite 的 WAL 模式实现多进程并发访问,确保数据一致性。
  • 安装步骤

    1. 安装运行环境:请确保安装了 Python 3.x。
    2. 安装依赖:pip install fastmcp
    3. 下载/获取代码:将仓库代码放在本地某目录。
    4. 启动 MCP 服务器:在服务器端执行 server.py(无需额外 client 端)。示例启动方式见下方“服务器配置”。
  • 服务器配置(MCP 客户端需要的最小信息) 说明:下面给出一个配置示例,帮助 MCP 客户端知道如何启动与连接该服务器。实际使用中,MCP 客户端并不需要包含服务器端实现的代码,仅需知道该服务器要如何启动即可。

    • server_name: sqlite_memory
    • command: python3
    • args: ["/path/to/server.py"]
    • env(可选):
      • SQLITE_MEMORY_DB: 指定数据库文件路径,默认路径为 ~/.claude/memory/memory.db
      • BRIDGE_REPO: 指定跨机桥接仓库路径,默认路径为 ~/.claude/memory/bridge

    说明性示例(JSON 形式,便于粘贴到配置文件中): { "server_name": "sqlite_memory", "command": "python3", "args": ["/path/to/server.py"], "env": { "SQLITE_MEMORY_DB": "/home/user/.claude/memory/memory.db", "BRIDGE_REPO": "/home/user/.claude/memory/bridge" } }

  • 基本使用方法

    • 启动与接入
      • 在 Claude Code 等环境中将服务器添加为 MCP 后端,命令通常为上述启动命令,确保 Memory 数据库路径与桥接仓库路径正确。
    • 客户端交互
      • 通过 MCP 客户端发送标准的 JSON-RPC 请求来读取资源、调用工具、获取提示模板等,服务器按 MCP 协议返回响应。
    • 日常使用要点
      • 通过工具接口管理知识图谱:创建实体、添加观测、建立关系、查询图谱。
      • 使用会话工具实现跨会话上下文记忆。
      • 通过 bridge_push / bridge_pull 实现跨机器的知识与任务同步。
      • 如需将部分内容公开给所有实例,可使用发布流程并在桥接阶段完成审核与发布。

服务器信息