CentralMind/Шлюз

🚀 Интерактивная демоверсия доступна здесь: https://centralmind.ai

Что такое Centralmind/Gateway

Простой способ предоставить доступ к вашей базе данных AI-Agent через протоколы MCP или OpenAPI 3.1.

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

Это запустит для вас 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/ 

Что вы можете использовать внутри своего ИИ-агента:

Gateway сгенерирует оптимизированный для ИИ API.

Почему Centralmind/Gateway

Агентам ИИ и приложениям на базе LLM нужен быстрый и безопасный доступ к данным. Мы создаем уровень API, который автоматически генерирует безопасные API, оптимизированные для LLM, для ваших структурированных данных.

Быстро начните с MCP или OpenAPI или используйте API Direct/Raw SQL
Фильтрует персональные данные и конфиденциальные данные для обеспечения соответствия GDPR, CPRA, SOC 2 и другим нормативным актам.
Добавляет возможности отслеживания и аудита, гарантируя, что приложения ИИ не являются черными ящиками, и позволяя службам безопасности сохранять контроль
Оптимизирован для рабочих нагрузок ИИ: поддерживает протокол контекста модели (MCP) с расширенными метаданными, помогающими агентам ИИ понимать API, а также встроенные функции кэширования и безопасности

Это может быть полезно во время разработки, когда LLM необходимо создавать, корректировать или запрашивать данные из вашей базы данных. В аналитических сценариях это позволяет вам общаться с вашей базой данных или хранилищем данных. Обогатите ваших агентов ИИ данными из вашей базы данных с помощью удаленного вызова функций/инструментов.

Функции

⚡ Автоматическая генерация API — автоматически создает API с использованием LLM на основе схемы таблицы и выборочных данных.
🗄️ Поддержка структурированных баз данных – поддерживает PostgreSQL, MySQL, ClickHouse, Snowflake, MSSQL, BigQuery, Oracle Database, SQLite, ElasticSearch
🌍 Поддержка нескольких протоколов — предоставляет API как сервер REST или MCP, включая режим SSE
📜 Документация API – автоматически сгенерированная документация Swagger и спецификация OpenAPI 3.1.0
🔒 Защита персональных данных — реализует плагин регулярных выражений или плагин Microsoft Presidio для редактирования персональных данных и конфиденциальных данных.
⚡ Гибкая конфигурация — легко расширяется с помощью конфигурации YAML и системы плагинов
🐳 Варианты развертывания — запуск в виде двоичного файла или контейнера Docker с готовым к использованию чартом Helm
🤖 Поддержка нескольких поставщиков ИИ - поддержка OpenAI , Anthropic , Amazon Bedrock , Google Gemini и Google VertexAI
📦 Локально и локально — поддержка размещенных самостоятельно LLM с помощью настраиваемых конечных точек и моделей ИИ
🔑 Безопасность на уровне строк (RLS) — детальный контроль доступа к данным с использованием скриптов Lua
🔐 Варианты аутентификации – Встроенная поддержка ключей API и OAuth
👀 Комплексный мониторинг — интеграция с OpenTelemetry (OTel) для отслеживания запросов и аудита
🏎️ Оптимизация производительности — реализует стратегии кэширования на основе времени и LRU

Как это работает

1. Подключайтесь и открывайте новое

Gateway подключается к вашим структурированным базам данных, таким как PostgreSQL, и автоматически анализирует схему и образцы данных для создания оптимизированной структуры API на основе вашего запроса. LLM используется только на этапе обнаружения для создания конфигурации API. Инструмент использует поставщиков AI для создания конфигурации API, обеспечивая безопасность посредством обнаружения PII.

2. Развертывание

Gateway поддерживает несколько вариантов развертывания из автономного двоичного файла, docker или Kubernetes. Ознакомьтесь с нашим руководством по запуску для получения подробных инструкций. Система использует конфигурацию YAML и плагины для легкой настройки.

3. Использование и интеграция

Доступ к данным через REST API или Model Context Protocol (MCP) со встроенными функциями безопасности. Gateway легко интегрируется с моделями и приложениями ИИ, такими как LangChain, OpenAI и Claude Desktop, с помощью вызова функций или Cursor через MCP. Вы также можете настроить телеметрию для локального или удаленного назначения в формате otel.

Документация

Начиная

Краткое руководство
Инструкция по установке
Руководство по созданию 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. Выполните следующие шаги:

Выберите одного из поддерживаемых нами поставщиков ИИ:

OpenAI и все OpenAI-совместимые поставщики
Антропный
Амазонка Бедрок
Google Vertex AI (антропный)
Google Близнецы

Google Gemini предоставляет щедрый бесплатный уровень . Вы можете получить ключ API, посетив Google AI Studio:

Студия искусственного интеллекта Google

После входа в систему вы можете создать ключ API в разделе API студии AI. Бесплатный уровень включает щедрое ежемесячное распределение токенов, что делает его доступным для целей разработки и тестирования.

Настройте авторизацию поставщика 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-композитор

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

Интеграция протокола MCP

Gateway реализует протокол MCP для бесшовной интеграции с Claude и другими инструментами. Подробные инструкции по настройке см. в нашем руководстве по интеграции Claude.

Чтобы добавить MCP Tool в Claude Desktop, просто измените конфигурацию 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