Sqlite Explorer

🚀 SQLite 數據庫資源管理器 MCP 服務器

SQLite 數據庫資源管理器 MCP 服務器是一個藉助 Model Context Protocol (MCP) 實現安全只讀訪問的 SQLite 數據庫服務器。它基於 FastMCP 框架構建，支持大語言模型（LLM）對 SQLite 數據庫進行探索與查詢，同時具備內置的安全功能與查詢驗證機制。

🚀 快速開始

克隆倉庫：

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

📦 安裝指南

系統要求

• Python 3.6+
• SQLite 數據庫文件（通過環境變量指定路徑）

依賴項

安裝所有必需的依賴項：

# 使用 pip
pip install -r requirements.txt

必須的包

• fastmcp：構建 MCP 服務器的框架

所有依賴項均在 requirements.txt 中列出，方便安裝。

安裝選項

您可以在 Claude Desktop 或 Cline VSCode 插件中安裝此 MCP 服務器。選擇適合您需求的選項。

選項 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 替換為您實際的路徑。

✨ 主要特性

MCP 工具

服務器為 LLM 提供以下工具：

read_query

在數據庫上執行 SELECT 查詢，帶有內置的安全驗證。功能包括：

• 查詢驗證和清理
• 參數綁定支持
• 行數限制 enforcement
• 結果格式化為字典

list_tables

列出數據庫中所有可用的表及其名稱。

describe_table

獲取特定表格的詳細架構信息，包括：

• 列名和類型
• NULL 約束
• 默認值
• 主鍵信息

安全功能

• 只讀訪問：確保數據庫只能以只讀模式訪問。
• 查詢驗證和清理：防止注入攻擊，確保輸入安全。
• 結果限制：控制返回的數據量，避免數據洩露風險。

📚 詳細文檔

有關開發和集成的詳細信息，請參考 FastMCP 文檔 和 GitHub 倉庫。

📄 環境變量

• SQLITE_DB_PATH：指定 SQLite 數據庫文件的路徑。例如，/path/to/your/database.db。

在運行服務器之前，請確保設置此環境變量以正確訪問數據庫文件。