SingleStore MCP 서버

모델 컨텍스트 프로토콜 (MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 컨텍스트를 관리하도록 설계된 표준화된 프로토콜입니다. 이 저장소는 Singlestore용 설치 프로그램과 MCP 서버를 제공하여 원활한 통합을 지원합니다.

MCP를 사용하면 Claude Desktop, Cursor 또는 호환되는 모든 MCP 클라이언트를 사용하여 자연어로 SingleStore와 상호 작용할 수 있으므로 복잡한 작업을 손쉽게 수행할 수 있습니다.

요구 사항

파이썬 >= v3.11.0
파이썬 환경에 uvx가 설치되어 있습니다
Claude Desktop, Cursor 또는 다른 지원되는 LLM 클라이언트

클라이언트 설정

1. Init 명령

MCP 서버를 설정하는 가장 간단한 방법은 초기화 명령을 사용하는 것입니다.

지엑스피1

이 명령은 다음을 수행합니다.

사용자 인증
플랫폼에 맞는 구성 파일을 자동으로 찾습니다.
SingleStore MCP 서버를 포함하도록 구성을 생성하거나 업데이트합니다.
서버 시작에 대한 지침을 제공합니다

<SINGLESTORE_API_KEY> 명시적으로 전달할 수도 있습니다.

uvx singlestore-mcp-server init <SINGLESTORE_API_KEY>

클라이언트(예: claude 또는 cursor )를 지정하려면 --client 플래그를 사용합니다.

uvx singlestore-mcp-server init <SINGLESTORE_API_KEY> --client=<client>

2. Smithery를 통한 설치

Smithery 를 통해 mcp-server-singlestore 자동으로 설치하려면:

npx -y @smithery/cli install @singlestore-labs/mcp-server-singlestore --client=<client>

필요에 따라 <client> claude 나 cursor 로 바꾸세요.

3. 수동 구성

클로드 데스크탑과 커서

클라이언트 구성 파일에 다음 구성을 추가합니다.

클로드 데스크탑 :
커서
{ "mcpServers": { "singlestore-mcp-server": { "command": "uvx", "args": [ "singlestore-mcp-server", "start", "<SINGLESTORE_API_KEY>" ] } } }

구성을 변경한 후 클라이언트를 다시 시작합니다.

구성 요소

도구

서버는 다음 도구를 구현합니다.

workspace_groups_info : 사용자가 액세스할 수 있는 작업 공간 그룹에 대한 세부 정보를 검색합니다.
- 인수가 필요하지 않습니다
- 작업 공간 그룹의 세부 정보를 반환합니다.
workspaces_info : 특정 작업 공간 그룹의 작업 공간에 대한 세부 정보를 검색합니다.
- 인수: workspaceGroupID (문자열)
- 작업 공간의 세부 정보를 반환합니다.
organization_info : 사용자의 현재 조직에 대한 세부 정보를 검색합니다.
- 인수가 필요하지 않습니다
- 조직의 세부 정보를 반환합니다.
list_of_regions : 사용자의 작업 공간을 지원하는 모든 지역 목록을 검색합니다.
- 인수가 필요하지 않습니다
- 지역 목록을 반환합니다.
execute_sql : 연결된 작업 공간에서 SQL 작업 실행
- 인수: workspace_group_identifier , workspace_identifier 식별자, username , password , database , sql_query
- 구조화된 형식으로 SQL 쿼리 결과를 반환합니다.
list_virtual_workspaces : 사용자가 액세스할 수 있는 모든 시작 작업 공간을 나열합니다.
- 인수가 필요하지 않습니다
- 사용 가능한 시작 작업 공간의 세부 정보를 반환합니다.
create_virtual_workspace : 사용자로 새로운 시작 작업 공간을 만듭니다.
- 인수:
  - name : 스타터 작업 공간의 이름
  - database_name : 생성할 데이터베이스의 이름
  - username : 작업 공간에 액세스하기 위한 사용자 이름
  - password : 사용자의 비밀번호
  - workspace_group : name (선택 사항)과 cellID (필수)를 포함하는 객체
- 생성된 작업 공간 및 사용자의 세부 정보를 반환합니다.
execute_sql_on_virtual_workspace : 가상 작업 공간에서 SQL 작업 실행
- 인수: virtual_workspace_id , username , password , sql_query
- 데이터, 행 수, 열 및 상태를 포함하는 구조화된 형식으로 SQL 쿼리 결과를 반환합니다.
list_notebook_samples : SingleStore Spaces에서 사용 가능한 모든 노트북 샘플을 나열합니다.
- 인수가 필요하지 않습니다
- 사용 가능한 노트북 샘플의 세부 정보를 반환합니다.
create_notebook : 사용자의 개인 공간에 새로운 노트북을 생성합니다.
- 인수: notebook_name , content (선택 사항)
- 생성된 노트북의 세부 정보를 반환합니다.
list_personal_files : 사용자 개인 공간에 있는 모든 파일을 나열합니다.
- 인수가 필요하지 않습니다
- 사용자의 개인 공간에 있는 모든 파일의 세부 정보를 반환합니다.
create_scheduled_job : 노트북을 실행하기 위한 새로운 예약된 작업을 생성합니다.
- 인수:
  - name : 직업의 이름
  - notebook_path : 실행할 notebook의 경로
  - schedule_mode : 한 번 또는 반복
  - execution_interval_minutes : 실행 간 간격(분) (선택 사항)
  - start_at : 작업을 시작할 시점(선택 사항)
  - description : 직무 설명 (선택 사항)
  - create_snapshot : 노트북 스냅샷을 생성할지 여부(선택 사항)
  - runtime_name : 런타임 환경의 이름
  - parameters : 작업에 대한 매개변수(선택 사항)
  - target_config : 작업에 대한 대상 구성(선택 사항)
- 생성된 작업의 세부 정보를 반환합니다.
get_job_details : 특정 직업에 대한 세부 정보를 가져옵니다.
- 인수: job_id
- 지정된 작업에 대한 자세한 정보를 반환합니다.
list_job_executions : 특정 작업에 대한 실행 기록을 나열합니다.
- 인수: job_id , start (선택 사항), end (선택 사항)
- 지정된 작업에 대한 실행 기록을 반환합니다.

SingleStore MCP Server

Integrations