SurrealDB의 호스팅된 MCP 서버(mcp.surrealdb.com)를 사용하면 Claude Code가 로컬 서버 없이도 SurrealDB 인스턴스를 쿼리, 배포 및 관리할 수 있으며 Spectron 메모리를 사용할 수 있습니다.

변경 사항 — 호스팅된 SurrealDB MCP 서버

SurrealDB가 기존의 자체 설치형 SurrealMCP를 대체하는 호스팅된 MCP 서버를 출시했습니다. 이제 Claude Code에 단 하나의 URL만 추가하면 됩니다:

claude mcp add surrealdb https://mcp.surrealdb.com

그 다음 계정 포털에서 SurrealDB 계정 또는 개인 액세스 토큰(Personal Access Token)으로 인증하면 끝입니다. 로컬 서버도, 인스턴스별 설정도 필요 없습니다.

이 서버는 (Cursor 스크린샷에서 볼 수 있듯이) 쿼리부터 프로비저닝(Provisioning)까지 모든 것을 아우르는 **90개의 도구(Tools)**를 제공합니다. 이는 각 인스턴스나 컨텍스트를 개별적으로 구성해야 했던 이전 설정 방식에서 대폭 업그레이드된 것입니다.

사용자에게 주는 의미

복사-붙여넣기 반복 없이 데이터 쿼리하기

이전에는 Claude Code가 SurrealDB 데이터를 분석하게 하려면 스키마(Schema)와 쿼리 결과를 채팅창에 직접 복사해서 붙여넣어야 했습니다. 이제는 다음과 같이 질문하기만 하면 됩니다:

"지난주에 상태별로 주문이 얼마나 들어왔는지 알려줘."

Claude Code는 적절한 데이터베이스를 찾아 쿼리를 작성하고 실행한 뒤, SQL(또는 SurrealQL)과 결과값을 모두 보여줍니다. 사전에 스키마를 설명할 필요도 없습니다. 스스로 테이블을 조사(Introspect)하기 때문입니다.

중요: 인스턴스 쿼리를 위해서는 SurrealDB 3.2.3 이상 버전이 필요합니다.

질문을 통한 리소스 배포 및 관리

SurrealDB Studio 대시보드에서 클릭으로 수행하던 모든 작업을 이제 대화로 처리할 수 있습니다. 다음과 같은 작업이 가능합니다:

• 새로운 인스턴스 또는 컨텍스트 배포
• SurrealDB 버전 업그레이드
• 사용자 초대 및 액세스 권한(Access Levels) 관리
• 월간 지출액 확인

배포 시 MCP 서버는 구성을 제안하고 예상 비용을 제시하며, 실행하기 전에 사용자의 확인을 기다립니다.

Spectron을 통한 지속적인 메모리

이것이 바로 핵심 기능(killer feature)입니다. MCP 서버는 AI 에이전트를 위한 SurrealDB의 메모리 계층인 Spectron에 직접 연결됩니다. 사용자는 메모리를 저장하고, 문서를 보관하며, 단순한 키워드가 아닌 의미(meaning)를 기반으로 나중에 이를 검색할 수 있습니다. 이를 통해 Claude Code는 세션이 바뀌어도 유지되는 지속적인 두뇌(persistent brain)를 갖게 됩니다.

Claude Code에서 다음과 같이 시도해 보세요:

"메모리 저장: 우리의 프로덕션 인스턴스는 SurrealDB 3.2.5를 사용하며, customer 테이블은 email에 인덱스(index)가 설정되어 있음."

그 다음 새로운 세션에서:

"우리 프로덕션 인스턴스에 관한 메모리를 검색해줘."

지금 바로 시도해 보세요

1. 서버 추가: Claude Code에 서버를 추가합니다.

   claude mcp add surrealdb https://mcp.surrealdb.com

2. 인증: 브라우저 로그인 또는 개인 액세스 토큰(personal access token)을 통해 인증합니다.

3. 쿼리(query) 테스트:

   "customer 테이블의 필드(fields)와 인덱스(indexes)를 설명해줘."

4. 리소스 배포:

   "스테이징용으로 가장 작은 크기의 새로운 SurrealDB 인스턴스를 생성해줘."

5. 메모리 설정:

   "우리 API 속도 제한(rate limit)이 분당 100회(100 req/min)라는 점을 저장해줘."

전체 설정 가이드는 Claude 전용 문서를 확인하세요.

결론

이 호스팅된 MCP 서버는 로컬 설정 및 인스턴스별 구성의 번거로움을 제거합니다. SurrealDB를 사용하는 Claude Code 사용자에게 이제 CLI에서 쿼리, 관리 및 기억을 수행하는 것은 매우 간단한 일이 되었습니다. 이미 SurrealDB를 사용하고 있다면, 이는 고민할 필요 없는 업그레이드입니다.

출처: dev.to

원문 게시지: gentic.news