Sqlite Explorer MCP Server

🚀 SQLite 探索者 MCP 服務器

這是一個藉助模型上下文協議（MCP）實現的 MCP 服務器，可提供對 SQLite 數據庫的安全、只讀訪問。它基於 FastMCP 框架構建，能讓大型語言模型（LLMs）安全地探索和查詢 SQLite 數據庫，同時內置了安全性功能和查詢驗證機制。

🚀 快速開始

克隆倉庫：

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

✨ 主要特性

• 提供對 SQLite 數據庫的安全、只讀訪問。
• 基於 FastMCP 框架構建，便於大型語言模型（LLMs）探索和查詢數據庫。
• 內置安全性功能和查詢驗證機制。

📦 安裝指南

系統要求

• 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 探索者" -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 查詢，具有內置的安全驗證功能。特點：

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

list_tables

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

describe_table

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

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

🔒 安全功能

• 只讀訪問 SQLite 數據庫。
• 查詢驗證和清理。
• 參數綁定以安全執行查詢。
• 行數限制 enforcement。
• 進度輸出 suppression 以保持乾淨的 JSON 響應。

📚 詳細文檔

該倉庫包含開發文檔：

• mcp-documentation.txt：包含有關 MCP 服務器實現和 FastMCP 框架使用的全面文檔。

此文檔在開發時作為上下文使用，並可用於與 LLM 結合使用以協助開發。