SQLite Memory MCP Server
使用说明(简要版,便于快速上手)
-
项目简介
- 这是一个完整的 MCP 服务器实现,基于快速的 MCP 框架(FastMCP),使用 SQLite 作为后端存储,提供知识图谱的资源管理、工具执行、提示模板管理,以及会话跟踪、跨机器桥接与任务管理等能力,支持多会话并发访问。
-
主要功能点(面向使用者的要点)
- 资源与知识图谱管理:创建实体、添加观测、建立关系、执行全文检索(FTS5 BM25)。
- 工具执行与数据访问:提供多种工具接口来读取/修改知识图谱及相关元数据。
- 会话与记忆:会话保存、 recalls、以及跨会话连续上下文能力。
- 任务管理:内置任务/待办管理、分组、筛选、提醒与归档等。
- 跨机桥接:通过本地桥仓库实现跨机器的知识与任务同步。
- 公共知识与评价:发布待审知识、对公共知识进行评分、评价与信度分析。
- 安全与并发:使用 SQLite 的 WAL 模式实现多进程并发访问,确保数据一致性。
-
安装步骤
- 安装运行环境:请确保安装了 Python 3.x。
- 安装依赖:pip install fastmcp
- 下载/获取代码:将仓库代码放在本地某目录。
- 启动 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 实现跨机器的知识与任务同步。
- 如需将部分内容公开给所有实例,可使用发布流程并在桥接阶段完成审核与发布。
- 启动与接入