mcp-turso

Turso에서 호스팅하는 LibSQL 데이터베이스에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 현재 이 서버는 다음과 같은 기능을 제공합니다.

• 데이터베이스에서 테이블 목록 검색

• 데이터베이스 스키마 검색

• 테이블의 스키마 검색

• SELECT 쿼리 수행

구성

Claude Desktop과 함께

claude_desktop_config.json 에 다음을 추가하세요:

지엑스피1

계속하려면 기존 데이터베이스가 필요합니다. 데이터베이스가 없으면 새로 만드세요 . Turso CLI를 통해 데이터베이스 URL을 가져오려면 다음을 실행하세요.

그런 다음 데이터베이스 인증 토큰을 가져옵니다.

위에 표시된 대로 해당 값을 구성에 추가합니다.

커서 포함

커서를 사용하여 Turso MCP 서버를 구성하려면 커서 설정에 다음을 추가하세요.

1. 커서를 열고 설정(⚙️) > 설정(JSON)으로 이동합니다.

2. 설정 JSON에 다음 구성을 추가합니다.

이전 섹션에서 설명한 대로 your_url 과 your_token Turso 데이터베이스 URL과 인증 토큰으로 바꾸세요.

벌채 반출

서버에는 Claude Desktop 외부에서 디버깅하기 위한 사용자 지정 로거가 포함되어 있습니다. 기본적으로 이 로거는 <parent-dir>/logs/mcp-turso.log 에 기록합니다. 여기서 <parent-dir> 은 mcp-turso 스크립트가 포함된 디렉터리의 상위 디렉터리입니다. 즉, mcp-turso 경로가 ~/foo/bin/mcp-turso 이면 로그는 ~/foo/logs/mcp-turso.log 에 저장됩니다. 위와 같이 NPX를 실행하는 경우 기본 로그는 다음과 같습니다.

사용자 지정 경로를 지정하려면 서버 구성에 --logs 플래그와 절대 POSIX 경로를 포함하면 됩니다.

로그 파일 경로(기본 또는 사용자 지정)는 서버 생성 시 항상 stderr 에 기록됩니다. Claude 데스크톱의 경우, ~/Library/Logs/Claude 의 서버 로그에 표시됩니다.

참고 : 현재 Windows에 대한 사용자 정의 로깅 파일을 지정하는 기능은 구현하지 않았지만 곧 구현될 예정입니다.

서버 기능

서버는 다음과 같은 도구를 제공합니다.

• list_tables

  • 데이터베이스에 있는 모든 테이블 목록을 가져옵니다.

  • 입력 없음

  • 반환: 테이블 이름 배열

• get_db_schema

  • 데이터베이스의 모든 테이블 스키마를 가져옵니다.

  • 입력 없음

  • 반환: SQL 생성 문의 배열

• describe_table

  • 특정 테이블에 대한 스키마 정보 보기

  • 입력:

    • table_name (문자열): 설명할 테이블의 이름

  • 반환: 이름과 유형이 포함된 열 정의 배열

• query_database

  • 데이터베이스에서 데이터를 읽기 위해 SELECT 쿼리를 실행합니다.

  • 입력:

    • sql (문자열): 실행할 SELECT SQL 쿼리

  • 반환: { columns: string[]; rows: Record<string, unknown>[]; rowCount: number; } 유형의 객체로 쿼리 결과

할 일

• [ ] Windows에서 사용자 정의 로그 파일을 지정하는 기능 추가

• [ ] 더 많은 쿼리 도구 추가

특허

MIT 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.