센트럴마인드/게이트웨이

🚀 대화형 데모는 여기에서 이용 가능합니다: https://centralmind.ai

센트럴마인드/게이트웨이란 무엇인가요?

MCP 또는 OpenAPI 3.1 프로토콜을 통해 AI-Agent에 데이터베이스를 노출하는 간단한 방법입니다.

지엑스피1

이렇게 하면 API가 실행됩니다.

INFO Gateway server started successfully!         
INFO MCP SSE server for AI agents is running at: http://localhost:9090/sse 
INFO REST API with Swagger UI is available at: http://localhost:9090/ 

AI 에이전트 내부에서 사용할 수 있는 항목:

게이트웨이는 AI에 최적화된 API를 생성합니다.

센트럴마인드/게이트웨이를 선택해야 하는 이유

AI 에이전트와 LLM 기반 애플리케이션은 데이터에 빠르고 안전하게 액세스할 수 있어야 합니다. 구조화된 데이터에 대해 안전하고 LLM에 최적화된 API를 자동으로 생성하는 API 계층을 구축하고 있습니다.

MCP 또는 OpenAPI로 빠르게 시작하거나 직접/원시 SQL API를 사용하세요.
GDPR, CPRA, SOC 2 및 기타 규정을 준수하기 위해 PII 및 민감한 데이터를 필터링합니다.
추적 가능성과 감사 기능을 추가하여 AI 애플리케이션이 블랙박스가 아닌지 확인하고 보안 팀이 제어를 유지할 수 있도록 합니다.
AI 워크로드에 최적화: AI 에이전트가 API를 이해하는 데 도움이 되는 향상된 메타데이터와 내장 캐싱 및 보안 기능을 갖춘 MCP(모델 컨텍스트 프로토콜)를 지원합니다.

개발 과정에서 LLM이 데이터베이스에서 데이터를 생성, 조정 또는 쿼리해야 할 때 유용할 수 있습니다. 분석 시나리오에서는 데이터베이스 또는 데이터웨어하우스와 통신할 수 있습니다. 원격 함수/도구 호출을 사용하여 데이터베이스의 데이터로 AI 에이전트를 강화할 수 있습니다.

특징

⚡ 자동 API 생성 – 테이블 스키마와 샘플링된 데이터를 기반으로 LLM을 사용하여 자동으로 API를 생성합니다.
🗄️ 구조화된 데이터베이스 지원 – PostgreSQL, MySQL, ClickHouse, Snowflake, MSSQL, BigQuery, Oracle Database, SQLite, ElasticSearch 지원
🌍 다중 프로토콜 지원 – SSE 모드를 포함한 REST 또는 MCP 서버로 API 제공
📜 API 문서 – 자동 생성된 Swagger 문서 및 OpenAPI 3.1.0 사양
🔒 PII 보호 – PII 및 민감한 데이터 삭제를 위한 정규식 플러그인 또는 Microsoft Presidio 플러그인 구현
⚡ 유연한 구성 – YAML 구성 및 플러그인 시스템을 통해 쉽게 확장 가능
🐳 배포 옵션 – 사용 가능한 Helm 차트를 사용하여 바이너리 또는 Docker 컨테이너로 실행
🤖 다양한 AI 공급자 지원 - OpenAI , Anthropic , Amazon Bedrock , Google Gemini 및 Google VertexAI 지원
📦 로컬 및 온프레미스 – 구성 가능한 AI 엔드포인트 및 모델을 통해 자체 호스팅 LLM 지원
🔑 행 수준 보안(RLS) – Lua 스크립트를 사용한 세분화된 데이터 액세스 제어
🔐 인증 옵션 – API 키 및 OAuth에 대한 기본 지원
👀 종합 모니터링 – 요청 추적 및 감사 추적을 위한 OpenTelemetry(OTel)와의 통합
🏎️ 성능 최적화 – 시간 기반 및 LRU 캐싱 전략 구현

작동 원리

1. 연결하고 발견하세요

Gateway는 PostgreSQL과 같은 구조화된 데이터베이스에 연결하여 스키마와 데이터 샘플을 자동으로 분석하여 사용자의 요청에 따라 최적화된 API 구조를 생성합니다. LLM은 API 구성을 생성하는 검색 단계에서만 사용됩니다. 이 도구는 AI 제공자를 사용하여 PII 탐지를 통해 보안을 강화하는 동시에 API 구성을 생성합니다.

2. 배포

Gateway는 독립 실행형 바이너리, Docker 또는 Kubernetes 등 다양한 배포 옵션을 지원합니다. 자세한 내용은 시작 가이드를 참조하세요. 시스템은 YAML 구성 및 플러그인을 사용하여 손쉽게 사용자 지정할 수 있습니다.

3. 사용 및 통합

내장된 보안 기능이 포함된 REST API 또는 MCP(Model Context Protocol)를 통해 데이터에 액세스하세요. Gateway는 MCP를 통해 함수 호출 또는 Cursor를 사용하여 LangChain, OpenAI, Claude Desktop과 같은 AI 모델 및 애플리케이션과 완벽하게 통합됩니다. 또한 호텔 형식으로 로컬 또는 원격 대상에 대한 원격 측정을 설정할 수 있습니다.

선적 서류 비치

시작하기

빠른 시작 가이드
설치 지침
API 생성 가이드
API 출시 가이드

추가 자료

ChatGPT 통합 가이드
데이터베이스 커넥터 문서
플러그인 문서

빌드하는 방법

# Clone the repository
git clone https://github.com/centralmind/gateway.git

# Navigate to project directory
cd gateway

# Install dependencies
go mod download

# Build the project
go build .

API 생성

Gateway는 LLM 모델을 사용하여 API 구성을 생성합니다. 다음 단계를 따르세요.

지원되는 AI 공급업체 중 하나를 선택하세요.

Google Gemini는 넉넉한 무료 등급을 제공합니다. Google AI Studio를 방문하여 API 키를 받으실 수 있습니다.

구글 AI 스튜디오

로그인 후 AI Studio의 API 섹션에서 API 키를 생성할 수 있습니다. 무료 티어에는 넉넉한 월별 토큰 할당이 포함되어 있어 개발 및 테스트 목적으로 사용할 수 있습니다.

AI 공급자 권한을 구성하세요. Google Gemini의 경우 API 키를 설정하세요.

export GEMINI_API_KEY='yourkey'

검색 명령을 실행합니다.

./gateway discover \
  --ai-provider gemini \
  --connection-string "postgresql://neondb_owner:MY_PASSWORD@MY_HOST.neon.tech/neondb?sslmode=require" \
  --prompt "Generate for me awesome readonly API"

생성 과정을 즐겨보세요:

INFO 🚀 API Discovery Process
INFO Step 1: Read configs
INFO ✅ Step 1 completed. Done.

INFO Step 2: Discover data
INFO Discovered Tables:
INFO   - payment_dim: 3 columns, 39 rows
INFO   - fact_table: 9 columns, 1000000 rows
INFO ✅ Step 2 completed. Done.

# Additional steps and output...

INFO ✅ All steps completed. Done.

INFO --- Execution Statistics ---
INFO Total time taken: 1m10s
INFO Tokens used: 16543 (Estimated cost: $0.0616)
INFO Tables processed: 6
INFO API methods created: 18
INFO Total number of columns with PII data: 2

gateway.yaml 에서 생성된 구성을 검토하세요.

api:
  name: Awesome Readonly API
  description: ''
  version: '1.0'
database:
  type: postgres
  connection: YOUR_CONNECTION_INFO
  tables:
    - name: payment_dim
      columns: # Table columns
      endpoints:
        - http_method: GET
          http_path: /some_path
          mcp_method: some_method
          summary: Some readable summary
          description: 'Some description'
          query: SQL Query with params
          params: # Query parameters

API 실행

지역적으로 실행

./gateway start --config gateway.yaml

도커 컴포즈

docker compose -f ./example/simple/docker-compose.yml up

MCP 프로토콜 통합

Gateway는 Claude 및 기타 도구와의 원활한 통합을 위해 MCP 프로토콜을 구현합니다. 자세한 설정 지침은 Claude 통합 가이드를 참조하세요.

Claude Desktop에 MCP 도구를 추가하려면 Claude의 구성을 조정하기만 하면 됩니다.

{
  "mcpServers": {
    "gateway": {
      "command": "PATH_TO_GATEWAY_BINARY",
      "args": ["start", "--config", "PATH_TO_GATEWAY_YAML_CONFIG", "mcp-stdio"]
    }
  }
}

로드맵

로드맵은 항상 변경될 수 있으며, 사용자 피드백을 바탕으로 작성될 예정입니다. 현재 다음과 같은 기능을 계획하고 있습니다.

데이터베이스 및 연결성

🗄️ 확장 데이터베이스 통합 - Redshift, S3(Iceberg 및 Parquet), Oracle DB, Microsoft SQL Server, Elasticsearch
🔑 SSH 터널링 - jumphost 또는 ssh bastion을 사용하여 연결을 터널링하는 기능

향상된 기능

🔍 고급 쿼리 기능 - 복잡한 필터링 구문 및 매개변수로서의 집계 함수
🔐 향상된 MCP 보안 - API 키 및 OAuth 인증

플랫폼 개선

📦 스키마 관리 - 자동화된 스키마 진화 및 API 버전 관리
🚦 고급 트래픽 관리 - 지능형 속도 제한, 요청 조절
✍️ 쓰기 작업 지원 - 삽입, 업데이트 작업

CentralMind/Gateway

Integrations