SQLite Explorer MCP Server

一个通过模型上下文协议（MCP）提供安全、只读访问SQLite数据库的MCP服务器。该服务器基于FastMCP框架构建，使LLM能够通过内置的安全功能和查询验证来探索和查询SQLite数据库。

📋 系统要求

Python 3.6+
SQLite数据库文件（通过环境变量指定路径）

📦 依赖项

安装所有必需的依赖项：

# 使用pip
pip install -r requirements.txt

必需的包

fastmcp：用于构建模型上下文协议服务器的框架

所有依赖项均在requirements.txt中指定，便于安装。

📑 目录

系统要求
依赖项
MCP工具
入门指南
安装选项
- Claude桌面版
- 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

📦 安装选项

您可以选择在Claude桌面版或Cline VSCode插件中安装此MCP服务器。选择最适合您需求的选项。

选项1：为Claude桌面版安装

使用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插件：

在VSCode中，点击Cline插件侧边栏中的服务器图标（☰）
点击“编辑MCP设置”按钮（✎）
在设置文件中添加以下配置：

{
  "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数据库文件的完整路径

hannesrudolph/sqlite-explorer-fastmcp-mcp-server

星标增长

证据时间轴