SQLite Explorer MCP 服务器

这是一个通过模型上下文协议（MCP）提供对 SQLite 数据库安全只读访问的 MCP 服务器。该服务器使用 FastMCP 框架构建，使大型语言模型能够探索和查询 SQLite 数据库，并具有内置的安全特性和查询验证功能。

📋 系统需求

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

📦 依赖项

安装所有必需的依赖项：

# 使用 pip
pip install -r requirements.txt

必需的包

• fastmcp: 构建 Model Context Protocol 服务器的框架

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

📑 目录

• 系统需求
• 依赖项
• MCP 工具
• 快速开始
• 安装选项
  • Claude Desktop
  • Cline VSCode 插件
• 安全特性
• 开发文档
• 环境变量

🛠️ MCP 工具

服务器向大型语言模型暴露以下工具：

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. 点击“编辑 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 为克隆此仓库的完整路径（例如，/Users/username/Projects/sqlite-explorer-fastmcp-mcp-server）
• /path/to/your/database.db 为您的 SQLite 数据库文件的完整路径

🔒 安全特性

• 对 SQLite 数据库的只读访问
• 查询验证和清理
• 参数绑定以确保安全的查询执行
• 行数限制强制执行
• 抑制进度输出以获得干净的 JSON 响应

📚 开发文档

仓库包含开发文档文件：

• mcp-documentation.txt: 包含关于 MCP 服务器实现和 FastMCP 框架使用的全面文档。

这些文档在开发功能时作为上下文，并可用于与大型语言模型配合以协助开发。

⚙️ 环境变量

必须设置以下环境变量：

• SQLITE_DB_PATH: 要探索的 SQLite 数据库文件的完整路径