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 结合使用以协助开发。