Sqlite Explorer MCP Server

🚀 SQLite 探索者 MCP サーバ

このサーバは、モデルコンテキストプロトコル（MCP）を通じて、SQLite データベースへの安全で読み取り専用のアクセスを提供します。FastMCP フレームワークを使用して構築され、大規模言語モデル（LLMs）が安全に SQLite データベースを探索およびクエリできるようになっており、セキュリティ機能とクエリ検証が組み込まれています。

🚀 クイックスタート

リポジトリをクローンします：

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

✨ 主な機能

• 大規模言語モデル（LLMs）が安全に SQLite データベースを探索およびクエリできるようにする。
• セキュリティ機能とクエリ検証が組み込まれている。

📦 インストール

📋 システム要件

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

📦 依存関係

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

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

必須パッケージ

• fastmcp：MCP フレームワークを構築するツール

すべての依存関係は requirements.txt に含まれており、インストールが容易です。

📦 インストールオプション

この MCP サーバは、Claude Desktop または Cline VSCode プラグインにインストールできます。最適なオプションを選択してください。

オプション1：Claude Desktop 用にインストール

FastMCP を使用してインストールします：

fastmcp install sqlite_explorer.py --name "SQLite 探索者" -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",
      "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 データベースファイルの完全なパスに置き換えてください。

💻 使用例

🔧 MCP ツール

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

read_query

データベース上で SELECT クエリを実行し、組み込みのセキュリティ検証機能を備えています。特徴：

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

list_tables

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

describe_table

特定のテーブルの詳細なスキーマ情報を取得します。以下を含みます：

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

🔧 技術詳細

🔒 セキュリティ機能

• SQLite データベースへの読み取り専用アクセス
• クエリ検証とクリーニング
• パラメータバインディングによる安全なクエリ実行
• 行数制限の適用
• クリーンな JSON レスポンスを維持するための進捗出力の抑制

📚 ドキュメント

このリポジトリには開発ドキュメントが含まれています：

• mcp-documentation.txt：MCP サーバの実装と FastMCP フレームワークの使用に関する包括的なドキュメントが含まれています。

このドキュメントは開発時にコンテキストとして使用され、LLM と組み合わせて開発を支援するために使用できます。