AI记忆存储服务

MemoryBank MCP是一个安全的个人记忆保险库,专为AI助手设计,提供记忆存储、检索和组织功能,支持OIDC认证和MCP协议。

  • by ldorelli
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 ldorelli/memorybank-mcp

使用说明

内存库MCP🧠

为您的AI助手提供安全的个人存储库。

Secure. Private. Retro-Chic.

MemoryBank允许LLM(通过模型上下文协议)在安全的PostgreSQL保险库中存储、检索和组织关于你的“记忆”。它具有一个完整的OIDC身份验证服务器,具有自定义 粉彩复古像素艺术 UI。

特性

  • 🔐 安全认证:带有JWT访问令牌的自定义OIDC提供程序。
  • 🎨 柔和复古UI:美丽的像素艺术主题登录、注册和同意屏幕(VT323 排版)。
  • 🚀 独立注册:直接创建帐户 /signup.
  • 🧠 内存工具: save_memory, list_memories, search_memories, delete_memory.
  • 🔌 通用运输:支持MCP流式HTTP(POST)和SSE(GET)。 OIDC认证服务器和专门为AI代理设计的MCP服务器。

项目结构

  • auth-server/:OIDC提供者(Node.js+节点OIDC提供者)
  • mcp-server/:MCP服务器(Node.js+@modelcontextprotocol/sdk)
  • docker-compose.yml:PostgreSQL数据库
  • init.sql:数据库架构初始化

本地开发

先决条件

  • Docker&Docker编写
  • Node.js 20+

1.启动数据库

docker-compose up -d

这将使用中定义的模式在端口5432上启动PostgreSQL init.sql.

2.启动认证服务器

cd auth-server
npm install
# Generates self-signed certs if missing and starts server
npm start

继续运行 https://localhost:3000.

3.启动MCP服务器

cd mcp-server
npm install
npm start

继续运行 http://localhost:3001.

测试

自动化流程

运行测试脚本以验证完整流程(用户->登录->令牌->保存注释):

node test_flow.js

人工验证

  1. 登录首选 https://localhost:3000/auth?client_id=mcp_client&response_type=code&scope=openid&redirect_uri=https://oauth.pstmn.io/v1/callback
  2. 主控程序:使用令牌访问MCP工具。

部署(铁路)

  1. 数据库:创建PostgreSQL服务。
  2. 身份验证服务器:部署 auth-server/.Set DATABASE_URL.
  3. MCP服务器:部署 mcp-server/.Set JWKS_URL 到 <auth-url>/jwks.