SQLite Explorer MCP 서버

모델 컨텍스트 프로토콜(MCP)을 통해 SQLite 데이터베이스에 대한 안전한 읽기 전용 액세스를 제공하는 MCP 서버입니다. 이 서버는 FastMCP 프레임워크를 기반으로 구축되었으며, LLM은 내장된 안전 기능과 쿼리 검증 기능을 통해 SQLite 데이터베이스를 탐색하고 쿼리할 수 있습니다.

📋 시스템 요구 사항

• 파이썬 3.6 이상

• SQLite 데이터베이스 파일(환경 변수를 통해 지정된 경로)

Related MCP server: Jewei MSSQL MCP Server

📦 종속성

필요한 모든 종속성을 설치하세요:

지엑스피1

필수 패키지

• fastmcp : 모델 컨텍스트 프로토콜 서버를 구축하기 위한 프레임워크

모든 종속성은 requirements.txt 에 지정되어 있어 쉽게 설치할 수 있습니다.

📑 목차

• 시스템 요구 사항

• 종속성

• MCP 도구

• 시작하기

• 설치 옵션

  • 클로드 데스크탑

  • 클라인 VSCode 플러그인

• 안전 기능

• 개발 문서

• 환경 변수

🛠️ MCP 도구

서버는 LLM에 다음 도구를 제공합니다.

읽기_쿼리

내장된 안전 검증 기능을 사용하여 데이터베이스에 SELECT 쿼리를 실행합니다. 기능:

• 쿼리 검증 및 정리

• 매개변수 바인딩 지원

• 행 제한 시행

• 사전 형식으로 된 결과

리스트_테이블

데이터베이스에서 사용 가능한 모든 테이블을 이름과 함께 나열합니다.

설명_테이블

다음을 포함하여 특정 테이블에 대한 자세한 스키마 정보를 가져옵니다.

• 열 이름 및 유형

• NULL 제약 조건

• 기본값

• 기본 키 정보

🚀 시작하기

저장소를 복제합니다.

git clone https://github.com/hannesrudolph/sqlite-explorer-fastmcp-mcp-server.git
cd sqlite-explorer-fastmcp-mcp-server

📦 설치 옵션

이 MCP 서버는 Claude Desktop 또는 Cline VSCode 플러그인에 설치할 수 있습니다. 필요에 가장 적합한 옵션을 선택하세요.

옵션 1: Claude Desktop용 설치

FastMCP를 사용하여 설치:

fastmcp install sqlite_explorer.py --name "SQLite Explorer" -e SQLITE_DB_PATH=/path/to/db

/path/to/db SQLite 데이터베이스 파일 경로로 바꾸세요.

옵션 2: Cline VSCode 플러그인 설치

이 서버를 Cline VSCode 플러그인 과 함께 사용하려면:

1. VSCode에서 Cline 플러그인 사이드바의 서버 아이콘(☰)을 클릭합니다.

2. "MCP 설정 편집" 버튼을 클릭하세요(✎)

3. 설정 파일에 다음 구성을 추가합니다.

{
  "sqlite-explorer": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "--with",
      "uvicorn",
      "fastmcp",
      "run",
      "/path/to/repo/sqlite_explorer.py"
    ],
    "env": {
      "SQLITE_DB_PATH": "/path/to/your/database.db"
    }
  }
}

바꾸다:

• /path/to/repo 에 이 저장소를 복제한 전체 경로를 지정합니다(예: /Users/username/Projects/sqlite-explorer-fastmcp-mcp-server ).

• /path/to/your/database.db 에 SQLite 데이터베이스 파일의 전체 경로를 입력합니다.

🔒 안전 기능

• SQLite 데이터베이스에 대한 읽기 전용 액세스

• 쿼리 검증 및 정리

• 안전한 쿼리 실행을 위한 매개변수 바인딩

• 행 제한 시행

• 깨끗한 JSON 응답을 위한 진행 출력 억제

📚 개발 문서

저장소에는 개발을 위한 문서 파일이 포함되어 있습니다.

• mcp-documentation.txt : MCP 서버 구현과 FastMCP 프레임워크 사용에 대한 포괄적인 설명서가 포함되어 있습니다.

이 문서는 기능을 개발할 때 맥락으로 활용되며 LLM과 함께 사용하여 개발을 지원할 수 있습니다.

⚙️ 환경 변수

다음 환경 변수를 설정해야 합니다.

• SQLITE_DB_PATH : 탐색하려는 SQLite 데이터베이스 파일의 전체 경로