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。

在运行服务器之前，请确保设置此环境变量以正确访问数据库文件。