🚀 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 插件 中使用：
- 在 VSCode 中，点击左侧边栏中的服务器图标 (☰)
- 点击“编辑 MCP 设置”按钮 (✎)
- 将以下配置添加到设置文件中：
{
"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。
在运行服务器之前，请确保设置此环境变量以正确访问数据库文件。