Name: centralmind/gateway
Rating: 5 (529 reviews)
Author: centralmind/gateway

CentralMind Gateway: Dakikalar İçinde API veya MCP Sunucusu Oluşturun

🚀 İnteraktif Demo burada kullanılabilir: https://centralmind.ai

Centralmind/Gateway Nedir

Veritabanınızı MCP veya OpenAPI 3.1 protokolleri aracılığıyla AI-Agent'e sunmanın basit yolu.

docker run --platform linux/amd64 -p 9090:9090 \
  ghcr.io/centralmind/gateway:v0.2.18 start \
  --connection-string "postgres://db-user:db-password@db-host/db-name?sslmode=require"

Bu sizin için bir API çalıştıracak:

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/

Bunu AI Agent'inizde kullanabilirsiniz:

Gateway, AI için optimize edilmiş API oluşturur.

Neden Centralmind/Gateway

AI agent'leri ve LLM-destekli uygulamalar verilere hızlı ve güvenli erişim gerektirir. Yapılandırılmış verileriniz için otomatik olarak güvenli, LLM-optimize API'ler üreten bir API katmanı oluşturuyoruz.

MCP veya OpenAPI ile hızlı başlayın veya Doğrudan/Raw SQL API'lerini kullanın
GDPR, CPRA, SOC 2 ve diğer düzenlemelerle uyumluluğu sağlamak için KŞV'leri ve hassas verileri filtreleyip çıkarır
İzlenebilirlik ve denetim yeteneklerini ekleyerek, AI uygulamalarının kara kutu olmamasını ve güvenlik ekiplerinin kontrol sahibi kalmasını sağlar
AI workload'ları için optimize edilmiş: AI agent'lerinin API'leri anlamasına yardımcı olmak için geliştirilmiş metaveri ile Model Context Protocol (MCP) desteği sunar, dahili caching ve güvenlik özellikleriyle birlikte

Geliştirme sırasında, bir LLM'nin veritabanınızdan veri oluşturması, ayarlaması veya sorgulaması gerektiğinde yararlı olabilir. Analiz senaryolarında, veritabanı veya veri ambarınızla sohbet etmenizi sağlar. Uzaktan function/tool çağrısı kullanarak veritabanınızdan veri ile AI agent'lerinizi zenginleştirin.

demo

Özellikler

⚡ Otomatik API Oluşturma – Tablo şeması ve örnek verilere dayalı olarak LLM kullanarak API'leri otomatik olarak oluşturur
🗄️ Yapılandırılmış Veritabanı Desteği – PostgreSQL, MySQL, ClickHouse, Snowflake, MSSQL, BigQuery, Oracle Database, SQLite, ElasticSearch destekler
🌍 Çoklu Protocol Desteği – SSE modu da dahil olmak üzere API'ler REST veya MCP Sunucusu olarak sağlar
🔐 Kimlik Doğrulama Seçenekleri – API anahtarları ve OAuth için yerleşik destek
🔒 KŞV Koruması – KŞV ve hassas verileri redakte etmek için regex plugin veya Microsoft Presidio plugin uygular
👀 Kapsamlı Monitoring – İstek takibi ve denetim günlükleri için OpenTelemetry (OTel) entegrasyonu
📦 Yerel ve Şirket İçi – Yapılandırılabilir AI endpoint'leri ve modellerle kendi barındırılan LLM'ler için destek
🤖 Çoklu AI Provider Desteği - OpenAI, Anthropic, Amazon Bedrock, Google Gemini & Google VertexAI desteği
⚡ Esnek Konfigürasyon – YAML konfigürasyonu ve plugin sistemi aracılığıyla kolayca genişletilebilir
📜 API Dokümantasyonu – Otomatik olarak oluşturulan Swagger dokümantasyonu ve OpenAPI 3.1.0 şartnamesi
🔑 Satır Seviyesi Güvenlik (RLS) – Lua scriptleri kullanarak ince taneli veri erişim kontrolü
🏎️ Performans Optimizasyonu – Zaman tabanlı ve LRU caching stratejilerini uygular

Nasıl Çalışır

1. Bağlan ve Keşfet

Gateway, PostgreSQL gibi yapılandırılmış veritabanlarına bağlanır ve şemayı otomatik olarak analiz eder ve şemanız temelinde optimize edilmiş bir API yapısı oluşturmak için örnek verileri örneklendir. LLM sadece API konfigürasyonu üretmek için keşif aşamasında kullanılır. Araç, güvenliği KŞV algılaması aracılığıyla sağlarken API konfigürasyonunu oluşturmak için AI Providers kullanır.

2. Dağıt

Gateway, tek başına ikili dosyadan, docker'dan veya Kubernetes'ten çeşitli dağıtım seçeneklerini destekler. Detaylı talimatlar için başlatma rehberimize bakın. Sistem, kolay özelleştirme için YAML konfigürasyonu ve plugin'lerini kullanır.

3. Kullan ve Entegre Et

Yerleşik güvenlik özellikleriyle REST API'leri veya Model Context Protocol (MCP) aracılığıyla verilerinize erişin. Gateway, LangChain, OpenAI ve Claude Desktop gibi AI modelleri ve uygulamalarla function calling veya Cursor'u MCP aracılığıyla sorunsuz bir şekilde entegre olur. Ayrıca telemetri'yi yerel veya uzak hedefe otel formatında ayarlayabilirsiniz.

Dokümantasyon

Başlarken

Ek Kaynaklar

Nasıl Derlenir

# Havuzu klonla
git clone https://github.com/centralmind/gateway.git

# Proje dizinine git
cd gateway

# Bağımlılıkları yükle
go mod download

# Projeyi derle
go build .

API Oluşturma

Gateway, API konfigürasyonunuzu oluşturmak için LLM modellerini kullanır. Şu adımları izleyin:

Desteklenen AI provider'larımızdan birini seçin:

OpenAI ve tüm OpenAI-uyumlu provider'lar
Anthropic
Amazon Bedrock
Google Vertex AI (Anthropic)
Google Gemini

Google Gemini cömert bir ücretsiz katman sağlar. Google AI Studio'yu ziyaret ederek bir API anahtarı alabilirsiniz:

Google AI Studio

Oturum açtıktan sonra, AI Studio'nun API bölümünde bir API anahtarı oluşturabilirsiniz. Ücretsiz katman, geliştirme ve test amaçları için erişilebilir kılarak cömert aylık token tahsisi içerir.

AI provider kimlik doğrulamasını yapılandırın. Google Gemini için bir API anahtarı ayarlayın.

export GEMINI_API_KEY='yourkey'

Keşif komutunu çalıştırın:

./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"

Oluşturma işleminin tadını çıkarın:

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 dosyasında oluşturulan konfigürasyonu gözden geçirin:

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'yi Çalıştırma

Yerel olarak çalıştır

./gateway start --config gateway.yaml

Docker Compose

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

MCP Protocol Entegrasyonu

Gateway, Claude ve diğer araçlarla sorunsuz entegrasyon için MCP protokolünü uygular. Detaylı kurulum talimatları için Claude entegrasyonu rehberimize bakın.

MCP Tool'u Claude Desktop'a eklemek için Claude'un konfigürasyonunu ayarlayın:

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

Yol Haritası

Her zaman değişikliğe tabi olur ve yol haritası yüksek oranda kullanıcı geri bildirimlerine bağlı olacaktır. Şu anda, aşağıdaki özellikleri planlıyoruz:

Veritabanı ve Bağlantı

🗄️ Genişletilmiş Veritabanı Entegrasyonları - Databricks, Redshift, S3 (Iceberg ve Parquet), Oracle DB, Microsoft SQL Server, Elasticsearch
🔑 SSH tunneling - jumphost veya ssh bastion kullanarak bağlantıları tünelleyebilme kabiliyeti

Geliştirilmiş İşlevsellik

🔍 Gelişmiş Sorgu Yetenekleri - Karmaşık filtreleme söz dizimi ve parametre olarak Aggregation fonksiyonları
🔐 Geliştirilmiş MCP Güvenliği - API anahtarı ve OAuth kimlik doğrulaması

Platform İyileştirmeleri

📦 Şema Yönetimi - Otomatik şema evrimi ve API versiyonlaması
🚦 Gelişmiş Trafik Yönetimi - Akıllı rate limiting, İstek azaltma
✍️ Yazma İşlemleri Desteği - Insert, Update işlemleri

centralmind/gateway

Bu MCP sunucusu hakkında