sqlite-explorer-fastmcp-mcp-server

by hannesrudolph
Verified

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 제약 조건
  • 기본값
  • 기본 키 정보

🚀 시작하기

저장소를 복제합니다.

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 데이터베이스 파일의 전체 경로
-
security - not tested
F
license - not found
-
quality - not tested

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

  1. 📋 System Requirements
    1. 📦 Dependencies
      1. Required Packages
    2. 📑 Table of Contents
      1. 🛠️ MCP Tools
        1. read_query
        2. list_tables
        3. describe_table
      2. 🚀 Getting Started
        1. 📦 Installation Options
          1. Option 1: Install for Claude Desktop
          2. Option 2: Install for Cline VSCode Plugin
        2. 🔒 Safety Features
          1. 📚 Development Documentation
            1. ⚙️ Environment Variables
              ID: 36pwdhgz0j