Database Analyzer MCP Server

基本能力

产品定位

mcp-server-demo 是一个专为 PostgreSQL 数据库设计的分析工具，提供数据库模式分析和安全查询执行功能。

核心功能

• 数据库模式分析
• 列出指定模式中的所有表
• 获取特定表的详细模式信息

• 查看列定义、数据类型和约束

• 安全查询执行

• 使用参数化输入执行 SELECT 查询
• 内置安全措施防止未经授权的修改

适用场景

• 数据库管理员需要快速了解数据库结构和关系
• 开发人员需要安全地执行查询以获取数据
• 数据分析师需要探索数据库模式以进行数据分析

工具列表

• Database Schema Analysis：提供数据库模式的分析功能。
• Safe Query Execution：提供安全的查询执行功能。

常见问题解答

• 数据库连接问题：确保 .env 文件中的数据库配置正确。
• 无效查询：确保查询语法正确且仅包含 SELECT 语句。
• 模式访问问题：确保数据库用户有足够的权限访问所需模式。

使用教程

使用依赖

• Python 3.x
• PostgreSQL 数据库
• 所需的 Python 包：
• mcp (Model Context Protocol)
• psycopg2 (PostgreSQL 适配器)
• python-dotenv (环境变量管理)

安装教程

1. 克隆仓库：

git clone <repository-url>
cd MCP-server-demo

1. 安装所需的包：

pip install -r requirements.txt

1. 在项目根目录创建 .env 文件，并填写数据库凭证：

POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DB=your_database_name
POSTGRES_USER=your_username
POSTGRES_PASSWORD=your_password

调试方式

1. 启动 MCP 服务器：

python server.py

1. 服务器提供以下工具：

2. Database Schema Analysis

3. Safe Query Execution

安全特性

• 仅允许 SELECT 查询以确保安全
• 参数化查询以防止 SQL 注入
• 基于环境变量的敏感数据配置
• 自动连接清理和资源管理

错误处理

服务器包含全面的错误处理功能，包括：

• 数据库连接问题
• 无效查询
• 模式访问问题
• 资源清理

许可证

None