SQLite MCP 서버

개요

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

Related MCP server: Database MCP Server

구성 요소

자원

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

• 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 리소스 업데이트를 트리거합니다.

Claude Desktop과 함께 사용

자외선

지엑스피1

도커

# Add the server to your claude_desktop_config.json
"mcpServers": {
  "sqlite": {
    "command": "docker",
    "args": [
      "run",
      "--rm",
      "-i",
      "-v",
      "mcp-test:/mcp",
      "mcp/sqlite",
      "--db-path",
      "/mcp/test.db"
    ]
  }
}

VS Code를 사용한 사용

빠른 설치를 위해 아래의 설치 버튼을 클릭하세요.

수동 설치의 경우, VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가하세요. Ctrl + Shift + P 를 누르고 Preferences: Open Settings (JSON) 입력하면 됩니다.

원하는 경우, 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 이렇게 하면 다른 사용자와 구성을 공유할 수 있습니다.

mcp.json 파일을 사용하려면 mcp 키가 필요합니다.

자외선

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "db_path",
        "description": "SQLite Database Path",
        "default": "${workspaceFolder}/db.sqlite"
      }
    ],
    "servers": {
      "sqlite": {
        "command": "uvx",
        "args": [
          "mcp-server-sqlite",
          "--db-path",
          "${input:db_path}"
        ]
      }
    }
  }
}

도커

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "db_path",
        "description": "SQLite Database Path (within container)",
        "default": "/mcp/db.sqlite"
      }
    ],
    "servers": {
      "sqlite": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-v",
          "mcp-sqlite:/mcp",
          "mcp/sqlite",
          "--db-path",
          "${input:db_path}"
        ]
      }
    }
  }
}

건물

도커:

docker build -t mcp/sqlite .

MCP 검사관으로 테스트

uv add "mcp[cli]"
mcp dev src/mcp_server_sqlite/server.py:wrapper  

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.