이것은 모델 컨텍스트 프로토콜(MCP) 서버로, PostgreSQL 데이터베이스와 채팅할 수 있게 해줍니다. Cloudflare를 통해 GitHub OAuth를 통해 원격 MCP 서버로 배포할 수 있습니다. 이 MCP는 운영 환경에 적합합니다.

주요 특징

• ** 🗄️ Lifespan과의 데이터베이스 통합**: 모든 MCP 도구 호출에 대한 직접 PostgreSQL 데이터베이스 연결
• ** 🛠️ 모듈형 단일 목적 도구**: MCP 도구 및 그 설명에 관한 모범 사례 준수
• ** 🔐 역할 기반 접근**: GitHub 사용자 이름 기반 데이터베이스 쓰기 작업 권한
• ** 📊 스키마 발견**: 자동 테이블 및 열 정보 검색
• ** 🛡️ SQL 주입 보호**: 내장 검증 및 소독 기능
• ** 📈 모니터링**: 생산 모니터링을 위한 선택적 센트리 통합
• ** ☁️ 클라우드 네이티브**: Cloudflare Workers가 전 세계 규모를 위해 지원함

모듈러 아키텍처

이 MCP 서버는 확장 및 유지보수가 용이한 깔끔하고 모듈화된 아키텍처를 사용합니다:

• src/tools/ - 개별 도구 구현이 별도의 파일에 있습니다
• registerAllTools() - 중앙 집중식 공구 등록 시스템
• 확장 가능한 설계 - tools/에 파일을 생성하고 등록하여 새로운 도구를 추가합니다

Cloudflare Remote PostgreSQL Database MCP Server + GitHub OAuth

This is a Model Context Protocol (MCP) server that enables you to chat with your PostgreSQL database, deployable as a remote MCP server with GitHub OAuth through Cloudflare. This is production ready MCP.

Key Features

• 🗄️ Database Integration with Lifespan: Direct PostgreSQL database connection for all MCP tool calls
• 🛠️ Modular, Single Purpose Tools: Following best practices around MCP tools and their descriptions
• 🔐 Role-Based Access: GitHub username-based permissions for database write operations
• 📊 Schema Discovery: Automatic table and column information retrieval
• 🛡️ SQL Injection Protection: Built-in validation and sanitization
• 📈 Monitoring: Optional Sentry integration for production monitoring
• ☁️ Cloud Native: Powered by Cloudflare Workers for global scale

Modular Architecture

This MCP server uses a clean, modular architecture that makes it easy to extend and maintain:

• src/tools/ - Individual tool implementations in separate files
• registerAllTools() - Centralized tool registration system
• Extensible Design - Add new tools by creating files in tools/ and registering them

This architecture allows you to easily add new database operations, external API integrations, or any other MCP tools while keeping the codebase organized and maintainable.

Transport Protocols

This MCP server supports both modern and legacy transport protocols:

• /mcp - Streamable HTTP (recommended): Uses a single endpoint with bidirectional communication, automatic connection upgrades, and better resilience for network interruptions
• /sse - Server-Sent Events (legacy): Uses separate endpoints for requests/responses, maintained for backward compatibility

For new implementations, use the /mcp endpoint as it provides better performance and reliability.

How It Works

The MCP server provides three main tools for database interaction:

1. listTables - Get database schema and table information (all authenticated users)
2. queryDatabase - Execute read-only SQL queries (all authenticated users)
3. executeDatabase - Execute write operations like INSERT/UPDATE/DELETE (privileged users only)

Authentication Flow: Users authenticate via GitHub OAuth → Server validates permissions → Tools become available based on user’s GitHub username.

Security Model:

• All authenticated GitHub users can read data
• Only specific GitHub usernames can write/modify data
• SQL injection protection and query validation built-in

Simple Example First