SQLite MCP 서버

개요

SQLite를 통해 데이터베이스 상호작용 및 비즈니스 인텔리전스 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 SQL 쿼리 실행, 비즈니스 데이터 분석, 비즈니스 인사이트 메모 자동 생성이 가능합니다.

설치

1. 아직 Bun을 설치하지 않았다면 설치하세요.
2. 이 저장소를 복제하세요
3. 종속성 설치:지엑스피1
4. Claude Desktop에서 서버를 구성하려면 설정 스크립트를 실행하세요.
   bun run setup

설치 스크립트는 자동으로 서버 구성을 Claude Desktop 구성 파일에 추가합니다. 구성 파일은 다음 위치에 있습니다.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

구성 요소

자원

서버는 단일 동적 리소스를 노출합니다.

• memo://insights : 분석 중 발견된 통찰력을 집계하는 지속적으로 업데이트되는 비즈니스 통찰력 메모
  • 추가 인사이트 도구를 통해 새로운 인사이트가 발견되면 자동으로 업데이트됩니다.

프롬프트

서버는 데모 프롬프트를 제공합니다.

• mcp-demo : 사용자에게 데이터베이스 작업을 안내하는 대화형 프롬프트
  • 필수 인수: topic - 분석할 비즈니스 도메인
  • 적절한 데이터베이스 스키마와 샘플 데이터를 생성합니다.
  • 사용자를 분석 및 통찰력 생성 과정으로 안내합니다.
  • 비즈니스 인사이트 메모와 통합

도구

서버는 6가지 핵심 도구를 제공합니다.

쿼리 도구

• read-query
  • 데이터베이스에서 데이터를 읽기 위해 SELECT 쿼리를 실행합니다.
  • 입력:
    • query (문자열): 실행할 SELECT SQL 쿼리
  • 반환: 객체 배열로 쿼리 결과
• write-query
  • INSERT, UPDATE 또는 DELETE 쿼리 실행
  • 입력:
    • query (문자열): SQL 수정 쿼리
  • 반환: { affected_rows: number }
• create-table
  • 데이터베이스에 새 테이블을 만듭니다
  • 입력:
    • query (문자열): CREATE TABLE SQL 문
  • 반환: 테이블 생성 확인

스키마 도구

• list-tables
  • 데이터베이스의 모든 테이블 목록을 가져옵니다.
  • 입력이 필요하지 않습니다
  • 반환: 테이블 이름 배열
• describe-table
  • 특정 테이블에 대한 스키마 정보 보기
  • 입력:
    • table_name (문자열): 설명할 테이블의 이름
  • 반환: 이름과 유형이 포함된 열 정의 배열

분석 도구

• append-insight
  • 메모 리소스에 새로운 비즈니스 통찰력 추가
  • 입력:
    • insight (문자열): 데이터 분석을 통해 발견된 비즈니스 통찰력
  • 반환: 통찰력 추가 확인
  • memo://insights 리소스 업데이트를 트리거합니다.

개발

프로젝트 구조

• src/index.ts : 메인 서버 구현
• src/logger.ts : 로깅 유틸리티
• scripts/setup.ts : Claude Desktop 구성 스크립트

벌채 반출

서버는 다음에 대한 자세한 로그를 유지합니다.

• server.log : 프로젝트 루트 디렉토리에 위치합니다.
• 로그에는 타임스탬프, 로그 수준(DEBUG, INFO, WARN, ERROR, FATAL) 및 구조화된 메타데이터가 포함됩니다.

데이터 베이스

SQLite 데이터베이스 파일은 다음 위치에 생성됩니다.

• data.sqlite : 프로젝트 루트 디렉토리에 위치함
• 존재하지 않으면 자동으로 생성됩니다

사용 가능한 스크립트

• bun run setup : Claude Desktop에서 서버 구성
• bun run lint : ESLint 검사 실행
• bun run lint:fix : ESLint 문제를 자동으로 수정합니다.
• bun run inspect : MCP 검사기를 실행합니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.