afgong-sqlite-mcp-server

SQLite Explorer MCP サーバー

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

📋 システム要件

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

📦 依存関係

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

# Using pip
pip install -r requirements.txt

必須パッケージ

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

簡単にインストールできるよう、すべての依存関係は requirements.txt に指定されています。

📑 目次

• システム要件
• 依存関係
• MCP ツール
• はじめに
• インストール方法
  • Claude Desktop
  • Cline VSCode プラグイン
• 安全機能
• 開発ドキュメント
• 環境変数

🛠️ MCP ツール

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

read_query

組み込みの安全性検証を使用して、データベースに対して SELECT クエリを実行します。機能：

• クエリの検証とサニタイズ
• パラメーターのバインドをサポート
• 行数制限の適用
• 結果を辞書形式で出力

list_tables

データベース内で利用可能なすべてのテーブル名を一覧表示します。

describe_table

特定のテーブルの詳細なスキーマ情報を取得します。次の情報が含まれます。

• 列名と型
• 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. 「Edit MCP Settings」ボタン（✎）をクリックします
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 データベースファイルのフルパス