MCP 브레인

Supabase에 데이터를 저장하는 MCP 서버로 구현된 인지 기억 시스템입니다. 엔티티 및 관계를 지원하는 지식 그래프를 위한 여러 Claude 설치 환경에 걸쳐 영구 저장소를 제공합니다.

알아채다

이 작업은 아직 진행 중이므로 약간의 수정 없이는 완벽하게 작동할 거라고 기대하지 마세요. 저는 MCP 메모리 서버를 사용하고 있었지만, 여러 컴퓨터에 설치된 Claude에서도 동시에 작동하도록 하고 싶었습니다. 전송 프로세스를 해킹해 봤지만, 그게 어리석다고 판단되어 Supabase로 옮겼습니다. 일단 실행되면 작동하지만, 설치 과정이 기대만큼 깔끔하지는 않습니다. Claude Desktop에서 먼저 작동하도록 하는 대신, Cline Dev 또는 이와 유사한 프로그램을 사용하여 VSC에서 먼저 설정하는 것을 강력히 권장합니다. 저는 Claude Desktop, VSC를 두 대의 노트북과 VPS에서 모두 동일한 Supabase DB를 공유하며 사용할 수 있었습니다.

특징

• Supabase를 사용한 영구 저장소
• 엔티티와 관계가 있는 지식 그래프 구조
• 안전한 동시 액세스를 위한 데이터베이스 수준 잠금
• 크로스 플랫폼 지원(macOS, Linux, Windows)
• 자동 테이블 초기화
• 디버그 로깅 지원

필수 조건

• Node.js와 npm
• Claude 확장 기능이 있는 VSCode
• 다음 중 하나:
  • 새로운 Supabase 계정 및 프로젝트(기본 설치용)
  • 기존 설치의 Supabase 자격 증명(2차 설치용)

설치 유형

적절한 설치 유형을 선택하세요.

1. 기본 설치 : 새로운 Supabase 프로젝트로 mcp-brain을 설정합니다. 이는 brain을 사용할 첫 번째 머신을 위한 것입니다.
2. 보조 설치 : 동일한 Supabase 데이터베이스를 사용하여 추가 머신에 mcp-brain을 설치합니다. 이렇게 하면 여러 머신이 동일한 지식 그래프를 공유할 수 있습니다.

설치

설치 과정에는 프로젝트를 빌드하고 Supabase 자격 증명을 사용하여 구성하는 과정이 포함됩니다. 제공된 스크립트를 사용하여 자동으로 설치하거나 수동으로 설치할 수 있습니다.

기본 설치

mcp-brain을 처음 설치하는 경우:

1. https://supabase.com 에서 새로운 Supabase 프로젝트를 만드세요
2. 프로젝트 설정 > API에서 프로젝트 URL과 API 키를 가져옵니다.
3. 아래의 자동 또는 수동 설치 단계를 따르세요.
4. 보조 설치에 사용할 Supabase 자격 증명을 저장하세요.

2차 설치

추가 컴퓨터에 mcp-brain을 설치하는 방법:

1. 기본 설치에서 Supabase URL 및 API 키를 가져옵니다.
2. 아래의 자동 또는 수동 설치 단계를 따르세요.
3. 동일한 자격 증명을 사용하여 모든 인스턴스가 동일한 지식 그래프를 공유하도록 합니다.

옵션 A: 자동 설치

1. 프로젝트를 복제하고 빌드합니다.지엑스피1
2. 구성 스크립트를 실행합니다.
   npm run configure
   Supabase URL과 API 키를 입력하라는 메시지가 표시됩니다. 스크립트는 자동으로 다음을 수행합니다.
   • OS에 대한 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
   • 리눅스: ~/.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
   • Supabase 프로젝트 your-project-url url에 입력합니다.
   • Supabase API 키와 your-api-key 함께 사용하세요

   참고: 설정 파일이 이미 있는 경우 기존 MCP 서버 구성을 유지해야 합니다. mcpServers 객체 내의 mcp-brain 섹션만 추가하거나 업데이트하십시오.

Supabase 자격 증명은 Supabase 프로젝트 설정의 프로젝트 설정 > API에서 확인할 수 있습니다.

변경 사항 적용

설치 또는 구성 변경 후:

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 : 메모리 간의 연결을 생성합니다

클로드는 이러한 도구를 사용하여 정보를 지속적으로 저장하고 불러올 수 있습니다.

개발

• npm run build - TypeScript 프로젝트 빌드
• npm run configure - Supabase 자격 증명 구성
• npm start - MCP 서버를 직접 시작합니다(일반적으로 필요하지 않음)

건축학

• TypeScript와 @modelcontextprotocol/sdk를 사용합니다.
• Supabase 테이블에 데이터를 저장합니다.
  • 엔티티: 지식 그래프의 노드
  • 관계: 엔티티를 연결하는 에지
  • 잠금: 동시 액세스를 위한 데이터베이스 수준 잠금
• 첫 번째 실행 시 자동 테이블 생성
• 플랫폼 독립적인 구성

특허

MIT