Supabase Memory MCP Server

MCP 大脑

一个以 MCP 服务器形式实现的认知记忆系统，用于将数据存储在 Supabase 中。它为知识图谱提供跨不同 Claude 安装的持久存储，并支持实体和关系。

注意

这项工作仍在进行中，所以不要指望它能完美运行，除非进行一些调整。我之前使用的是MCP 内存服务器，但我希望它能在同时安装在不同电脑上的 Claude 上运行。我尝试了一个迁移过程，但觉得这很蠢，所以我把它迁移到了 Supabase。运行后就能正常工作，但安装过程不够完善。我强烈建议先在 VSC 中使用 Cline Dev 或类似工具进行设置，而不是先尝试在 Claude Desktop 中运行。我已经能够在两台不同的笔记本电脑和一台 VPS 上运行 Claude Desktop 和 VSC，它们共享同一个 Supabase 数据库。

特征

• 使用 Supabase 进行持久存储
• 具有实体和关系的知识图谱结构
• 数据库级锁定，确保安全并发访问
• 跨平台支持（macOS、Linux、Windows）
• 自动表初始化
• 调试日志支持

先决条件

• Node.js 和 npm
• 带有 Claude 扩展的 VSCode
• 以下之一：
  • 一个新的 Supabase 帐户和项目（用于主要安装）
  • 来自现有安装的 Supabase 凭据（用于二次安装）

安装类型

选择适当的安装类型：

1. 初始安装：使用新的 Supabase 项目设置 mcp-brain。这是第一台使用 mcp-brain 的机器。
2. 二次安装：使用相同的 Supabase 数据库在其他机器上安装 mcp-brain。这允许多台机器共享同一份知识图谱。

安装

安装过程包括构建项目并使用您的 Supabase 凭据进行配置。您可以使用提供的脚本自动执行此操作，也可以手动执行。

主要安装

首次安装 mcp-brain：

1. 在https://supabase.com创建一个新的 Supabase 项目
2. 从项目设置 > API 获取项目 URL 和 API 密钥
3. 按照以下自动或手动安装步骤进行操作
4. 保存您的 Supabase 凭据以供二次安装使用

二次安装

在其他机器上安装 mcp-brain：

1. 从您的主安装中获取 Supabase URL 和 API 密钥
2. 按照以下自动或手动安装步骤进行操作
3. 使用相同的凭据确保所有实例共享相同的知识图

选项 A：自动安装

1. 克隆并构建项目：
   git clone https://github.com/gtrusler/mcp-brain.git cd mcp-brain npm install npm run build
2. 运行配置脚本：
   npm run configure
   系统将提示您输入 Supabase URL 和 API 密钥。脚本将自动执行以下操作：
   • 为您的操作系统创建或更新 MCP 设置文件
   • 配置构建文件的正确路径
   • 保留所有现有的 MCP 服务器配置

选项 B：手动安装

1. 克隆并构建项目：
   git clone https://github.com/gtrusler/mcp-brain.git cd mcp-brain npm install npm run build
2. 找到您的 MCP 设置文件：
   • macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Windows： %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
3. 在设置文件中添加或更新 mcp-brain 配置：
   { "mcpServers": { "mcp-brain": { "command": "node", "args": ["path/to/mcp-brain/dist/index.js"], "env": { "SUPABASE_URL": "your-project-url", "SUPABASE_KEY": "your-api-key", "DEBUG": "false" } } } }
   代替：
   • path/to/mcp-brain为您克隆和构建存储库的绝对路径
   • your-project-url替换为你的 Supabase 项目 URL
   • your-api-key替换为你的 Supabase API 密钥

   注意：如果设置文件已存在，请务必保留所有现有的 MCP 服务器配置。只需在 mcpServers 对象中添加或更新 mcp-brain 部分即可。

您可以在 Supabase 项目设置中的项目设置 > API 下找到您的 Supabase 凭据。

应用更改

安装或任何配置更改后：

1. 如果 VSCode 已打开：
   • 关闭所有克劳德对话
   • 运行“开发人员：重新加载窗口”命令（Cmd/Ctrl + Shift + P，然后输入“reload”）
2. 如果 VSCode 已关闭：
   • 只需启动 VSCode，新配置就会自动加载

验证安装

重新加载 VSCode 后，通过以下方式验证设置：

1. 与克劳德创建新对话
2. 运行Can you use your brain?之类的命令来测试连接
3. 大脑应该对其功能做出反应

用法

大脑通过 MCP 协议提供三种主要工具：

1. read_graph ：读取整个知识图谱
2. create_entities ：将新记忆存储为实体
3. create_relations ：在记忆之间建立联系

这些工具可以通过 Claude 来持久地存储和调用信息。

发展

• npm run build构建 TypeScript 项目
• npm run configure - 配置 Supabase 凭据
• npm start - 直接启动 MCP 服务器（通常不需要）

建筑学

• 使用 TypeScript 和 @modelcontextprotocol/sdk
• 将数据存储在 Supabase 表中：
  • 实体：知识图谱中的节点
  • 关系：连接实体的边
  • 锁：用于并发访问的数据库级锁定
• 首次运行时自动创建表
• 独立于平台的配置

执照

麻省理工学院