PostgreSQL MCP Server

基本能力

产品定位

PostgreSQL MCP Server 是一个专门用于与 PostgreSQL 数据库交互的 MCP 服务，旨在通过 MCP 协议提供安全、高效的数据库操作能力。

核心功能

• 数据库连接：支持安全 PostgreSQL 连接，包括连接池和 SSL 加密。
• 查询执行：支持 SQL 查询执行、参数绑定、查询历史跟踪和统计收集。
• 模式管理：提供表列表、列元数据、主键、外键和索引信息。
• 数据库分析：支持数据库大小信息、活动监控和查询性能跟踪。
• 安全：API 速率限制、CORS 支持和安全头。
• 服务器功能：优雅关闭、跨域资源共享支持。

适用场景

• 需要安全连接到 PostgreSQL 数据库的应用。
• 需要执行复杂 SQL 查询并跟踪查询历史的场景。
• 需要管理数据库模式和元数据的开发任务。
• 需要监控数据库活动和性能的分析任务。

工具列表

1. test-connection：测试 PostgreSQL 数据库连接。
2. query：执行 SQL 查询。
3. list-tables：列出数据库中的表。
4. describe-table：描述表的模式。
5. get-database-stats：获取数据库统计信息。
6. get-query-history：获取查询历史。
7. clear-query-history：清除查询历史。

常见问题解答

• 如何测试连接？ 使用 test-connection 工具。
• 如何执行查询？ 使用 query 工具。
• 如何管理查询历史？ 使用 get-query-history 和 clear-query-history 工具。

使用教程

使用依赖

# 安装 Node.js 和 npm
# 确保已安装 PostgreSQL 客户端库

安装教程

# 克隆仓库
git clone https://github.com/yourusername/db-mcp-server.git
cd db-mcp-server

# 安装依赖
npm install

# 安装 TypeScript 类型定义
npm install --save-dev @types/uuid @types/redis

# 创建并配置 .env 文件
cp .env.example .env
# 编辑 .env 文件

调试方式

# 启动开发服务器
npm run dev

# 构建项目
npm run build

# 使用 MCP Inspector 测试
npm install -g @modelcontextprotocol/inspector
mcp-inspector --server-url http://localhost:3000

许可证

该项目遵循 MIT 开源许可条款。