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 エクスプローラー MCP サーバー

モデルコンテキストプロトコル(MCP)を介してSQLiteデータベースへの安全な読み取り専用アクセスを提供するMCPサーバー。このサーバーはFastMCPフレームワークを使用して構築されており、LLMは組み込みの安全機能とクエリ検証を使用してSQLiteデータベースを探索およびクエリできます。

📋 システム要件

  • Python 3.6以上
  • SQLite データベース ファイル (環境変数で指定されたパス)

📦 依存関係

必要な依存関係をすべてインストールします。

# Using pip pip install -r requirements.txt

必要なパッケージ

  • 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