SQLite Explorer MCP Server

SQLite Explorer MCP Server

镜像

简介

SQLite Explorer 是一个基于模型上下文协议(MCP)的服务器,提供对 SQLite 数据库的安全、只读访问,让 AI 模型能够安全地探索和查询数据库。

系统要求

  • Python 3.6+
  • SQLite 数据库文件

安装步骤

1. 克隆仓库

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

2. 安装依赖

pip install -r requirements.txt

3. 配置选项

选项 1: Claude 桌面版安装

fastmcp install sqlite_explorer.py --name "SQLite Explorer" -e SQLITE_DB_PATH=/path/to/db

选项 2: Cline VSCode 插件安装

  1. 点击 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"
    }
  }
}

可用工具

  • read_query: 执行安全的 SELECT 查询,支持参数绑定
  • list_tables: 列出数据库中所有表
  • describe_table: 获取表的详细结构信息

环境变量

必须设置 SQLITE_DB_PATH 环境变量,指向 SQLite 数据库文件的完整路径。

安全特性

  • 只读访问保护
  • 查询验证与清理
  • 参数绑定支持
  • 结果行数限制

更多详情请参考仓库中的 mcp-documentation.txt 文档。