Provides optional tools for connecting to PostgreSQL databases, executing queries, exploring schema, and performing data analysis on PostgreSQL databases.
Provides tools for connecting to SQLite databases, executing queries, exploring schema, and performing data analysis on SQLite databases.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-db-assistant List all employees in the Sales department."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
基于 MCP (Model Context Protocol) 协议的数据库操作服务器，使用 FastMCP 框架构建，为 AI 客户端提供数据库连接、查询、Schema 探索、数据分析和 SQL 生成工具。
26个MCP工具，覆盖数据库操作全流程
SQLite内置支持，启动即用，无需额外安装数据库
PostgreSQL可选支持，通过 psycopg2 扩展
自动示例数据库，包含 employees / departments / salaries 三张表和索引
pandas数据分析，提供表统计、列统计、数据质量报告、值分布等高级分析
SQL构建器，参数化生成 SELECT / INSERT / UPDATE / CREATE TABLE / JOIN
安全防护，标识符验证防止 SQL 注入，SELECT/UPDATE 分离执行
Related MCP server: mcp-database
pip install -r requirements.txtpython server.py服务器启动后会自动创建示例数据库 sample.db 并连接。
在 MCP 客户端配置文件中添加：
{
"mcpServers": {
"db-assistant": {
"command": "python",
"args": ["server.py"],
"cwd": "/path/to/mcp-db-assistant"
}
}
}启动时自动创建的 sample.db 包含以下表：
列名 | 类型 | 说明 |
id | INTEGER PK | 部门ID |
name | TEXT | 部门名称 |
manager_id | INTEGER FK | 部门经理(引用employees.id) |
location | TEXT | 所在地 |
budget | REAL | 预算 |
列名 | 类型 | 说明 |
id | INTEGER PK | 员工ID |
name | TEXT | 姓名 |
department_id | INTEGER FK | 部门ID(引用departments.id) |
position | TEXT | 职位 |
hire_date | TEXT | 入职日期 |
TEXT UNIQUE | 邮箱 | |
is_active | INTEGER | 是否在职(1=是, 0=否) |
列名 | 类型 | 说明 |
id | INTEGER PK | 工资记录ID |
employee_id | INTEGER FK | 员工ID(引用employees.id) |
amount | REAL | 工资金额 |
effective_date | TEXT | 生效日期 |
end_date | TEXT | 结束日期(NULL表示当前有效) |
工具 | 说明 |
| 连接 SQLite 数据库 |
| 连接 PostgreSQL（可选） |
| 列出所有数据库 |
| 获取当前连接状态 |
工具 | 说明 |
| 执行 SELECT 查询，返回 Markdown 表格 |
| 执行 INSERT/UPDATE/DELETE |
| 分页查询 |
| 导出结果（CSV/JSON/Markdown） |
| 执行计划分析 |
| 统计表行数 |
工具 | 说明 |
| 列出所有表 |
| 表结构详情 |
| 列出索引 |
| 获取建表语句 |
| 获取外键关系 |
工具 | 说明 |
| 表统计（行数/列数/大小） |
| 列统计（distinct/NULL/min/max/avg） |
| 数据质量报告（完整性/唯一性） |
| 表采样数据 |
| NULL 值分析 |
| 值分布分析（直方图） |
工具 | 说明 |
| 构建 SELECT 语句 |
| 构建 INSERT 语句（参数化） |
| 构建 UPDATE 语句（参数化） |
| 构建 CREATE TABLE 语句 |
| 构建 JOIN 查询 |
mcp-db-assistant/
├── server.py # MCP Server入口（创建示例数据库+启动服务）
├── mcp_db_assistant/
│ ├── __init__.py # 包初始化（创建FastMCP实例+注册工具）
│ ├── connection.py # 数据库连接管理（4个工具）
│ ├── query_tools.py # 查询工具（6个工具）
│ ├── schema_tools.py # Schema探索工具（5个工具）
│ ├── analysis.py # 数据分析工具（6个工具）
│ └── sql_builder.py # SQL构建工具（5个工具）
├── README.md
├── SKILL.md
└── requirements.txtFastMCP - MCP协议Python实现
sqlite3 - Python标准库，SQLite数据库引擎
pandas - 数据分析和处理
psycopg2（可选） - PostgreSQL数据库适配器
运行单元测试：
pip install pytest flake8
pytest tests/ -v --tb=short代码质量检查：
flake8 . --count --max-line-length=120 --statisticsMIT License
This server cannot be deployed
MCP server for querying and analyzing data from ad platforms, analytics tools, and spreadsheets
GibsonAI MCP server: manage your databases with natural language
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
