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 凭据(用于二次安装)
安装类型
选择适当的安装类型:
- 初始安装:使用新的 Supabase 项目设置 mcp-brain。这是第一台使用 mcp-brain 的机器。
- 二次安装:使用相同的 Supabase 数据库在其他机器上安装 mcp-brain。这允许多台机器共享同一份知识图谱。
安装
安装过程包括构建项目并使用您的 Supabase 凭据进行配置。您可以使用提供的脚本自动执行此操作,也可以手动执行。
主要安装
首次安装 mcp-brain:
- 在https://supabase.com创建一个新的 Supabase 项目
- 从项目设置 > API 获取项目 URL 和 API 密钥
- 按照以下自动或手动安装步骤进行操作
- 保存您的 Supabase 凭据以供二次安装使用
二次安装
在其他机器上安装 mcp-brain:
- 从您的主安装中获取 Supabase URL 和 API 密钥
- 按照以下自动或手动安装步骤进行操作
- 使用相同的凭据确保所有实例共享相同的知识图
选项 A:自动安装
- 克隆并构建项目:
- 运行配置脚本:系统将提示您输入 Supabase URL 和 API 密钥。脚本将自动执行以下操作:
- 为您的操作系统创建或更新 MCP 设置文件
- 配置构建文件的正确路径
- 保留所有现有的 MCP 服务器配置
选项 B:手动安装
- 克隆并构建项目:
- 找到您的 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
- macOS:
- 在设置文件中添加或更新 mcp-brain 配置:代替:
path/to/mcp-brain
为您克隆和构建存储库的绝对路径your-project-url
替换为你的 Supabase 项目 URLyour-api-key
替换为你的 Supabase API 密钥
注意:如果设置文件已存在,请务必保留所有现有的 MCP 服务器配置。只需在 mcpServers 对象中添加或更新 mcp-brain 部分即可。
您可以在 Supabase 项目设置中的项目设置 > API 下找到您的 Supabase 凭据。
应用更改
安装或任何配置更改后:
- 如果 VSCode 已打开:
- 关闭所有克劳德对话
- 运行“开发人员:重新加载窗口”命令(Cmd/Ctrl + Shift + P,然后输入“reload”)
- 如果 VSCode 已关闭:
- 只需启动 VSCode,新配置就会自动加载
验证安装
重新加载 VSCode 后,通过以下方式验证设置:
- 与克劳德创建新对话
- 运行
Can you use your brain?
之类的命令来测试连接 - 大脑应该对其功能做出反应
用法
大脑通过 MCP 协议提供三种主要工具:
read_graph
:读取整个知识图谱create_entities
:将新记忆存储为实体create_relations
:在记忆之间建立联系
这些工具可以通过 Claude 来持久地存储和调用信息。
发展
npm run build
构建 TypeScript 项目npm run configure
- 配置 Supabase 凭据npm start
- 直接启动 MCP 服务器(通常不需要)
建筑学
- 使用 TypeScript 和 @modelcontextprotocol/sdk
- 将数据存储在 Supabase 表中:
- 实体:知识图谱中的节点
- 关系:连接实体的边
- 锁:用于并发访问的数据库级锁定
- 首次运行时自动创建表
- 独立于平台的配置
执照
麻省理工学院
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
使用 Supabase 提供内存/知识图谱存储功能,使多个 Claude 实例能够安全地共享和维护具有实体存储、并发访问安全和全文搜索等功能的知识图谱。
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA memory server for Claude that stores and retrieves knowledge graph data in DuckDB, enhancing performance and query capabilities for conversations with persistent user information.Last updated a day ago82442TypeScriptMIT License
- -securityAlicense-qualityProvides knowledge graph functionality for managing entities, relations, and observations in memory with strict validation rules to maintain data consistency.Last updated 4 months ago6PythonMIT License
- -securityFlicense-qualityAn implementation of persistent memory for Claude using a local knowledge graph, allowing the AI to remember information about users across conversations with customizable storage location.Last updated 4 months ago53616JavaScript
- -securityFlicense-qualityA multi-tenant service that automatically monitors Supabase database changes, generates OpenAI embeddings, and maintains synchronized vector search capabilities for each tenant's projects.Last updated 4 months agoTypeScript