Sqlite Explorer

🚀 SQLite データベースリソースエクスプローラ MCP サーバ

このサーバは、Model Context Protocol (MCP) を通じてSQLiteデータベースへの安全な読み取り専用アクセスを提供します。FastMCPフレームワークを基に構築され、LLMがSQLiteデータベースを探索およびクエリできるようにし、安全機能とクエリ検証が組み込まれています。

🚀 クイックスタート

システム要件

• Python 3.6+
• SQLiteデータベースファイル（環境変数でパスを指定）

依存関係

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

# pipを使用
pip install -r requirements.txt

必須パッケージ

• fastmcp：MCPサーバを構築するためのフレームワーク

すべての依存関係は requirements.txt に記載されており、簡単にインストールできます。

リポジトリのクローン

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

✨ 主な機能

このサーバは、LLMに以下のツールを提供します。

read_query

データベース上でSELECTクエリを実行し、組み込みの安全検証付きです。機能は以下の通りです。

• クエリ検証とクリーニング
• パラメータバインディングのサポート
• 行数制限の適用
• 結果を辞書形式に整形

list_tables

データベース内のすべての利用可能なテーブルとその名前をリストします。

describe_table

特定のテーブルの詳細なスキーマ情報を取得します。内容は以下の通りです。

• 列名と型
• NULL制約
• デフォルト値
• 主キー情報

📦 インストール

この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 を実際のデータベースファイルのパスに置き換えてください。

オプション2：Cline VSCodeプラグイン用にインストール

このサーバを Cline VSCodeプラグイン で使用するには、以下の手順を実行します。

1. VSCodeで、左側のサイドバーのサーバアイコン (☰) をクリックします。
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 と /path/to/your/database.db を実際のパスに置き換えてください。

🔧 技術詳細

安全機能

• 読み取り専用アクセス：データベースが読み取り専用モードでのみアクセスできることを保証します。
• クエリ検証とクリーニング：注入攻撃を防止し、入力の安全性を確保します。
• 結果制限：返されるデータ量を制御し、データ漏洩のリスクを回避します。

開発ドキュメント

開発と統合に関する詳細な情報は、FastMCPドキュメント と GitHubリポジトリ を参照してください。

環境変数

• SQLITE_DB_PATH：SQLiteデータベースファイルのパスを指定します。例：/path/to/your/database.db。

サーバを実行する前に、この環境変数を設定してデータベースファイルに正しくアクセスできるようにしてください。

📄 ライセンス

原文書にライセンス情報が記載されていないため、このセクションは表示されません。