带身份验证的PostgreSQL MCP服务器
一个模型上下文协议（MCP）服务器，为Claude AI提供对PostgreSQL数据库的身份验证访问。通过GitHub OAuth 2.0身份验证支持Claude Web，并可以使用RDS PostgreSQL部署在EC2上。
特性
- 🔐 GitHub OAuth 2.0身份验证 -Claude Web的安全身份验证
- 🗄️ PostgreSQL集成 -通过架构发现实现完全数据库访问
- 🛠️ SQL查询工具 -执行自定义SQL查询
- 📊 资源发现 -浏览数据库表和模式
- ☁️ 生产就绪 -支持使用RDS PostgreSQL进行EC2部署
- 🚀 轻松设置 -基于Docker的PostgreSQL开发
快速开始
1.先决条件
- Node.js 18+
- PostgreSQL数据库（本地Docker或AWS RDS）
- GitHub OAuth应用程序（用于Claude Web身份验证）
- EC2实例（用于生产部署）
2.安装
git clone
cd mcp-server
npm install3.配置
复制示例环境文件并配置：
cp .env.example .env编辑 .env 使用您的设置：
# Database Configuration (RDS PostgreSQL)
DB_HOST=your-rds-endpoint.region.rds.amazonaws.com
DB_PORT=5432
DB_NAME=your_database_name
DB_USER=your_db_username
DB_PASSWORD=your_db_password
# Server Configuration (EC2)
SERVER_PORT=3000
SERVER_HOST=0.0.0.0
PUBLIC_URL=http://44.200.16.187:3000
# Authentication
JWT_SECRET=your-jwt-secret-at-least-32-characters-long
# GitHub OAuth (for Claude Web)
GITHUB_CLIENT_ID=your_github_oauth_app_client_id
GITHUB_CLIENT_SECRET=your_github_oauth_app_client_secret
GITHUB_REDIRECT_URI=http://44.200.16.187:3000/auth/callback
# Environment
NODE_ENV=production4.开发设置（可选）
使用Docker进行本地开发：
# Start PostgreSQL with sample data
docker-compose up -d
# Start development server
npm run dev5.生产部署
在EC2上：
# Build the application
npm run build
# Start with PM2 (recommended)
npm run pm2:start
# Or start directly
npm start6.使用方法
配置Claude Web：
- 服务器URL:
http://44.200.16.187:3000 - 客户端ID:
your_github_client_id
建筑
文件结构
src/index.ts-主MCP服务器（克劳德桌面的stdio传输）src/unified-server.ts-经过身份验证的MCP服务器（Claude Web的HTTP传输）src/auth.ts-JWT和API密钥认证中间件src/config.ts-配置管理与Zod验证src/simple-mcp.ts-用于测试的最小MCP服务器docker-compose.yml-PostgreSQL数据库设置init.sql-示例数据库模式和数据
数据库模式
服务器包括三个表的示例数据：
- 用户 -用户帐户（id、姓名、电子邮件、created_at）
- 产品 -产品目录（id、名称、价格、描述、类别）
- 订单 -订单历史记录（id、user_id、product_id、数量、总计_数量）
可用工具
query-对数据库执行SQL查询describe_table-获取详细的表架构信息
可用资源
postgres://table/{table_name}-访问单个数据库表
GitHub OAuth设置
1.创建GitHub OAuth应用程序
- 首选
- 点击“新建OAuth应用程序”
- 填写详细信息：
- 应用程序名称: MCP PostgreSQL Server - 你的家园: https://your-ngrok-url.ngrok-free.app - 授权回调URL: https://your-ngrok-url.ngrok-free.app/auth/callback
- 将客户端ID和客户端密码复制到您的
.env文件
2.更新ngrok的网址
使用ngrok时，更新以下两项：
- 你的
.env带有ngrok URL的文件 - 使用新回调URL的GitHub OAuth应用程序设置
发展
可用脚本
npm run dev-启动MCP服务器（stdio模式）npm run dev:unified-启动经过身份验证的MCP服务器（HTTP模式）npm run dev:simple-启动最小MCP服务器进行测试npm run build-将TypeScript构建为JavaScriptnpm run lint-运行ESLintnpm run typecheck-运行TypeScript类型检查
测试
在Claude中尝试以下提示：
What tables are available in the database?
Show me some sample data from the users table.
Which user has placed the most orders?
What's the total revenue from all orders?
Run this SQL: SELECT name, email FROM users WHERE created_at > '2020-01-01'安全
- 具有可配置密钥的JWT令牌
- GitHub OAuth 2.0 支持 PKCE
- 参数化SQL查询以防止注入
- 为Claude域配置CORS保护
- 基于环境的配置（代码中没有秘密）
故障排除
常见问题
- 没有工具、资源或提示 -确保服务器发送
notifications/tools/list_changed初始化后 - OAuth错误 -验证GitHub OAuth应用程序回调URL是否与您的ngrok URL匹配
- 数据库连接失败 -检查PostgreSQL容器是否正在运行
docker-compose ps - 404错误 -确保ngrok正在转发到正确的端口（3000）
调试模式
运行服务器时，通过检查终端输出启用详细日志记录。记录所有MCP请求和OAuth流。
许可证
麻省理工学院
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
支持
- 检查 MCP文件
- 查看上面的故障排除部分
- 为bug或功能请求打开问题