🚀 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 插件 一起使用此服务器：
- 在 VSCode 中，点击 Cline 插件侧边栏中的服务器图标（☰）。
- 点击“编辑 MCP 设置”按钮（✎）。
- 将以下配置添加到设置文件中：
{
"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 结合使用以协助开发。