使用说明
内存库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
人工验证
- 登录首选
https://localhost:3000/auth?client_id=mcp_client&response_type=code&scope=openid&redirect_uri=https://oauth.pstmn.io/v1/callback - 主控程序:使用令牌访问MCP工具。
部署(铁路)
- 数据库:创建PostgreSQL服务。
- 身份验证服务器:部署
auth-server/.SetDATABASE_URL. - MCP服务器:部署
mcp-server/.SetJWKS_URL到<auth-url>/jwks.