CentralMind Gateway

Expone bases de datos estructuradas a agentes de IA mediante protocolos MCP o OpenAPI 3.1, con APIs optimizadas para cargas de trabajo de IA.

GitHub

548

Prueba este MCPPatrocinado

Documentación

CentralMind Gateway: Crea un servidor API o MCP en minutos

🚀 Demo interactiva disponible aquí: https://centralmind.ai

¿Qué es Centralmind/Gateway

Forma sencilla de exponer tu base de datos a agentes de IA mediante protocolos MCP u OpenAPI 3.1.

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"

Esto ejecutará una API para ti:

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/

Que puedes usar dentro de tu agente de IA:

Gateway generará una API optimizada para IA.

¿Por qué Centralmind/Gateway?

Los agentes de IA y las aplicaciones impulsadas por LLM necesitan acceso rápido y seguro a los datos. Estamos construyendo una capa de API que genera automáticamente APIs seguras y optimizadas para LLM para tus datos estructurados.

Comienza rápidamente con MCP u OpenAPI, o usa APIs SQL directas o sin procesar
Filtra PII y datos sensibles para garantizar el cumplimiento de GDPR, CPRA, SOC 2 y otras regulaciones
Añade capacidades de trazabilidad y auditoría, asegurando que las aplicaciones de IA no sean cajas negras y permitiendo que los equipos de seguridad mantengan el control
Optimizado para cargas de trabajo de IA: soporta el Model Context Protocol (MCP) con metadatos mejorados para ayudar a los agentes de IA a entender las APIs, junto con funciones integradas de caché y seguridad

Puede ser útil durante el desarrollo, cuando un LLM necesita crear, ajustar o consultar datos de tu base de datos. En escenarios analíticos, te permite chatear con tu base de datos o almacén de datos. Enriquece tus agentes de IA con datos de tu base de datos mediante llamadas remotas a funciones/herramientas.

demo

Características

⚡ Generación automática de API – Crea APIs automáticamente usando LLM basado en el esquema de la tabla y datos de muestra
🗄️ Soporte de bases de datos estructuradas – Soporta PostgreSQL, MySQL, ClickHouse, Snowflake, MSSQL, BigQuery, Oracle Database, SQLite, ElasticSearch
🌍 Soporte de múltiples protocolos – Proporciona APIs como REST o servidor MCP, incluido el modo SSE
🔐 Opciones de autenticación – Soporte integrado para claves de API y OAuth
🔒 Protección de PII – Implementa regex plugin o Microsoft Presidio plugin para la redacción de PII y datos sensibles
👀 Monitoreo integral – Integración con OpenTelemetry (OTel) para el seguimiento de solicitudes y pistas de auditoría
📦 Local y On-Premises – Soporte para self-hosted LLMs mediante endpoints y modelos de IA configurables
🤖 Soporte de múltiples proveedores de IA - Soporte para OpenAI, Anthropic, Amazon Bedrock, Google Gemini y Google VertexAI
⚡ Configuración flexible – Fácilmente extensible mediante configuración YAML y sistema de plugins
📜 Documentación de API – Documentación Swagger generada automáticamente y especificación OpenAPI 3.1.0
🔑 Seguridad a nivel de fila (RLS) – Control de acceso a datos de grano fino mediante Lua scripts
🏎️ Optimización de rendimiento – Implementa estrategias de caché basadas en tiempo y LRU caching

Cómo funciona

1. Conectar y descubrir

Gateway se conecta a tus bases de datos estructuradas como PostgreSQL y analiza automáticamente el esquema y las muestras de datos para generar una estructura de API optimizada basada en tu prompt. El LLM se usa solo en la etapa de descubrimiento para producir la configuración de la API. La herramienta utiliza Proveedores de IA para generar la configuración de la API mientras garantiza la seguridad mediante la detección de PII.

2. Desplegar

Gateway admite múltiples opciones de despliegue desde binario independiente, docker o Kubernetes. Consulta nuestra guía de lanzamiento para instrucciones detalladas. El sistema utiliza configuración YAML y plugins para una fácil personalización.

3. Usar e integrar

Accede a tus datos a través de APIs REST o Model Context Protocol (MCP) con funciones de seguridad integradas. Gateway se integra perfectamente con modelos y aplicaciones de IA como LangChain, OpenAI y Claude Desktop mediante llamadas a funciones o Cursor a través de MCP. También puedes configurar telemetría a un destino local o remoto en formato otel.

Documentación

Primeros pasos

Recursos adicionales

Cómo compilar

# 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 .

Generación de API

Gateway utiliza modelos LLM para generar tu configuración de API. Sigue estos pasos:

Elige uno de nuestros proveedores de IA compatibles:

OpenAI y todos los proveedores compatibles con OpenAI
Anthropic
Amazon Bedrock
Google Vertex AI (Anthropic)
Google Gemini

Google Gemini ofrece un nivel gratuito generoso. Puedes obtener una clave de API visitando Google AI Studio:

Google AI Studio

Una vez que hayas iniciado sesión, puedes crear una clave de API en la sección de API de AI Studio. El nivel gratuito incluye una asignación mensual generosa de tokens, lo que lo hace accesible para fines de desarrollo y prueba.

Configura la autorización del proveedor de IA. Para Google Gemini, establece una clave de API.

export GEMINI_API_KEY='yourkey'

Ejecuta el comando de descubrimiento:

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

Disfruta del proceso de generació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

Revisa la configuración generada en 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

Ejecutar la API

Ejecutar localmente

./gateway start --config gateway.yaml

Docker Compose

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

Integración del protocolo MCP

Gateway implementa el protocolo MCP para una integración perfecta con Claude y otras herramientas. Para instrucciones detalladas de configuración, consulta nuestra guía de integración con Claude.

Para agregar la herramienta MCP a Claude Desktop, solo ajusta la configuración de Claude:

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

Hoja de ruta

Siempre está sujeta a cambios, y la hoja de ruta dependerá en gran medida de los comentarios de los usuarios. En este momento, estamos planificando las siguientes características:

Base de datos y conectividad

🗄️ Integraciones de bases de datos ampliadas - Databricks, Redshift, S3 (Iceberg y Parquet), Oracle DB, Microsoft SQL Server, Elasticsearch
🔑 Tunelización SSH - capacidad de usar jumphost o bastión SSH para tunelizar conexiones

Funcionalidad mejorada

🔍 Capacidades avanzadas de consulta - Sintaxis de filtrado compleja y funciones de agregación como parámetros
🔐 Seguridad MCP mejorada - Autenticación con clave de API y OAuth

Mejoras de plataforma

📦 Gestión de esquemas - Evolución automatizada de esquemas y versionado de API
🚦 Gestión avanzada de tráfico - Limitación de velocidad inteligente, estrangulamiento de solicitudes
✍️ Soporte de operaciones de escritura - Operaciones de inserción y actualización

CentralMind Gateway

Documentación

CentralMind Gateway: Crea un servidor API o MCP en minutos

¿Qué es Centralmind/Gateway

¿Por qué Centralmind/Gateway?

Características

Cómo funciona

1. Conectar y descubrir

2. Desplegar

3. Usar e integrar

Documentación

Primeros pasos

Recursos adicionales

Cómo compilar

Generación de API

Ejecutar la API

Ejecutar localmente

Docker Compose

Integración del protocolo MCP

Hoja de ruta

Base de datos y conectividad

Funcionalidad mejorada

Mejoras de plataforma

Gateway de base de datos en registros MCP