SQLite 数据库资源管理器 MCP 服务器

一个通过 Model Context Protocol (MCP) 提供安全只读访问的 SQLite 数据库服务器。此服务器基于 FastMCP 框架构建，使 LLM 能够探索和查询 SQLite 数据库，并内置了安全功能和查询验证。

📋 系统要求

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

📦 依赖项

安装所有必需的依赖项：

# 使用 pip
pip install -r requirements.txt

必须的包

• fastmcp：构建 MCP 服务器的框架

所有依赖项均在 requirements.txt 中列出，方便安装。

📑 目录

• 系统要求
• 依赖项
• MCP 工具
• 开始使用
• 安装选项
  • Claude Desktop
  • Cline VSCode 插件
• 安全功能
• 开发文档
• 环境变量

🛠️ MCP 工具

服务器为 LLM 提供以下工具：

read_query

在数据库上执行 SELECT 查询，带有内置的安全验证。功能包括：

• 查询验证和清理
• 参数绑定支持
• 行数限制 enforcement
• 结果格式化为字典

list_tables

列出数据库中所有可用的表及其名称。

describe_table

获取特定表格的详细架构信息，包括：

• 列名和类型
• NULL 约束
• 默认值
• 主键信息

🚀 开始使用

克隆仓库：

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

📦 安装选项

您可以在 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 替换为您实际的路径。

安全功能

• 只读访问：确保数据库只能以只读模式访问。
• 查询验证和清理：防止注入攻击，确保输入安全。
• 结果限制：控制返回的数据量，避免数据泄露风险。

开发文档

有关开发和集成的详细信息，请参考 FastMCP 文档 和 GitHub 仓库。

📄 环境变量

• SQLITE_DB_PATH：指定 SQLite 数据库文件的路径。例如，/path/to/your/database.db。

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