hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Provides safe, read-only access to SQLite databases through tools like read_query, list_tables, and describe_table
SQLite Explorer MCP 서버
모델 컨텍스트 프로토콜(MCP)을 통해 SQLite 데이터베이스에 대한 안전한 읽기 전용 액세스를 제공하는 MCP 서버입니다. 이 서버는 FastMCP 프레임워크를 기반으로 구축되었으며, LLM은 내장된 안전 기능과 쿼리 검증 기능을 통해 SQLite 데이터베이스를 탐색하고 쿼리할 수 있습니다.
📋 시스템 요구 사항
- 파이썬 3.6 이상
- SQLite 데이터베이스 파일(환경 변수를 통해 지정된 경로)
📦 종속성
필요한 모든 종속성을 설치하세요:
지엑스피1
필수 패키지
- fastmcp : 모델 컨텍스트 프로토콜 서버를 구축하기 위한 프레임워크
모든 종속성은 requirements.txt
에 지정되어 있어 쉽게 설치할 수 있습니다.
📑 목차
🛠️ MCP 도구
서버는 LLM에 다음 도구를 제공합니다.
읽기_쿼리
내장된 안전 검증 기능을 사용하여 데이터베이스에 SELECT 쿼리를 실행합니다. 기능:
- 쿼리 검증 및 정리
- 매개변수 바인딩 지원
- 행 제한 시행
- 사전 형식으로 된 결과
리스트_테이블
데이터베이스에서 사용 가능한 모든 테이블을 이름과 함께 나열합니다.
설명_테이블
다음을 포함하여 특정 테이블에 대한 자세한 스키마 정보를 가져옵니다.
- 열 이름 및 유형
- NULL 제약 조건
- 기본값
- 기본 키 정보
🚀 시작하기
저장소를 복제합니다.
📦 설치 옵션
이 MCP 서버는 Claude Desktop 또는 Cline VSCode 플러그인에 설치할 수 있습니다. 필요에 가장 적합한 옵션을 선택하세요.
옵션 1: Claude Desktop용 설치
FastMCP를 사용하여 설치:
/path/to/db
SQLite 데이터베이스 파일 경로로 바꾸세요.
옵션 2: Cline VSCode 플러그인 설치
이 서버를 Cline VSCode 플러그인 과 함께 사용하려면:
- VSCode에서 Cline 플러그인 사이드바의 서버 아이콘(☰)을 클릭합니다.
- "MCP 설정 편집" 버튼을 클릭하세요(✎)
- 설정 파일에 다음 구성을 추가합니다.
바꾸다:
/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 데이터베이스 파일의 전체 경로
This server cannot be installed
MCP를 통해 SQLite 데이터베이스에 대한 안전한 읽기 전용 액세스를 제공하는 MCP 서버입니다. 이 서버는 FastMCP 프레임워크를 기반으로 구축되었으며, LLM은 내장된 안전 기능과 쿼리 검증 기능을 통해 SQLite 데이터베이스를 탐색하고 쿼리할 수 있습니다.