Firmament Open Brain

Firmament 팀을 위한 공유 "컨텍스트 브레인"입니다. OB1에서 영감을 얻었지만 Railway에 맞게 가볍게 재구축했습니다. Postgres를 백엔드로 하는 MCP(Model Context Protocol) 서버로, 각 사용자는 AI 도구(Claude Desktop, Claude Code, claude.ai, Cursor 등)를 넘나들며 따라다니는 개인 메모리 저장소를 갖습니다. 메모리는 사용자별로 격리됩니다 — 여러분의 토큰은 오직 여러분 자신의 메모리만 볼 수 있습니다.

작동 방식

• 하나의 Railway 서비스(이 Node 앱) + 하나의 Railway Postgres.

• 각 사용자는 개인 토큰을 받습니다. MCP URL은 https://<host>/mcp/<token>입니다.

• 모든 메모리 읽기/쓰기는 해당 토큰이 가리키는 사용자로 범위가 제한됩니다. 토큰은 해시(SHA-256)되어 저장됩니다.

• 검색은 Postgres 전체 텍스트 검색과 부분 문자열 폴백을 사용합니다 — 임베딩 API 키가 필요 없습니다.

Related MCP server: LedgerMem MCP Server

노출되는 MCP 도구

클라이언트 연결

Claude Code:

claude mcp add --transport http openbrain https://<host>/mcp/<your-token>

Claude Desktop / claude.ai: 설정 → 커넥터 → 사용자 지정 커넥터 추가 → https://<host>/mcp/<your-token> 붙여넣기.

Cursor: 설정 → MCP → 서버 추가, http 유형, 같은 URL 입력.

그런 다음 그냥 말하면 됩니다: "...를 기억해줘" / "...에 대해 뭘 알고 있어?". 세션을 시작할 때 "내 오픈 브레인에서 <주제>에 대한 컨텍스트를 확인해줘"라고 말하는 습관을 들이는 것이 좋습니다.

관리자(사용자 발급)

ADMIN_TOKEN 환경 변수가 필요합니다. Bearer 토큰으로 전달하세요.

# create a user (returns their token + MCP URL — shown only once)
curl -X POST https://<host>/admin/users \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Jack Wright"}'

# list users
curl https://<host>/admin/users -H "Authorization: Bearer $ADMIN_TOKEN"

# delete a user (and all their memories)
curl -X DELETE https://<host>/admin/users/<id> -H "Authorization: Bearer $ADMIN_TOKEN"

배포(Railway)

앱 서비스의 환경 변수:

• DATABASE_URL — Railway Postgres 참조

• ADMIN_TOKEN — 긴 임의 문자열(관리자 API 인증)

• DATABASE_SSL — Railway 프라이빗 네트워킹으로 연결하는 경우 false로 설정

이 디렉토리에서 railway up으로 배포하세요. 스키마는 부팅 시 자동 생성됩니다.

보안 참고 사항

• 토큰이 URL에 들어 있습니다. 덕분에 한 번 붙여넣기만으로 연결이 가능하며, 소규모로 신뢰하는 팀에게는 허용할 만한 방식입니다. 하지만 URL을 비밀번호처럼 취급하세요: 공유하지 말고, 단체 채팅에 붙여넣지 마세요.

• 토큰 분실 → 사용자를 삭제하고 새로 발급하세요(메모리는 사용자 행에 연결되어 있으므로 사용자 삭제 시 메모리도 삭제됩니다 — 필요한 경우 먼저 내보내세요).