Database Gateway

CentralMind Gateway：几分钟内创建 API 或 MCP 服务

🚀 交互式演示请访问：https://centralmind.ai

什么是 Centralmind/Gateway

通过 MCP 或 OpenAPI 3.1 协议向 AI Agent 提供数据库访问能力的简便方式。

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"

这将为你运行一个 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 Agent 中使用它：

Gateway 会生成针对 AI 优化的 API。

为什么选择 Centralmind/Gateway

AI Agent 和由大模型驱动的应用需要快速、安全地访问数据。我们正在构建一个 API 层，可自动为结构化数据生成安全、针对大模型优化的 API。

• 快速开始使用 MCP 或 OpenAPI，或使用 Direct/Raw SQL API
• 过滤个人身份信息（PII）和敏感数据，确保符合 GDPR、CPRA、SOC 2 等法规要求
• 增加可追踪性和审计功能，确保 AI 应用不是黑箱，并让安全团队能够保持控制
• 针对 AI 工作负载进行了优化：支持带有增强元数据的模型上下文协议（MCP），帮助 AI Agent 理解 API，并内置缓存和安全功能

在开发过程中，当大模型需要创建、调整或查询数据库中的数据时，它会很有用。 在分析场景中，它可以让你与数据库或数据仓库对话。 通过远程函数/工具调用，使用数据库中的数据为 AI Agent 提供增强能力。

功能

• ⚡ 自动生成 API – 根据表结构和采样数据，使用大模型自动创建 API
• 🗄️ 支持结构化数据库 – 支持 PostgreSQL、MySQL、ClickHouse、Snowflake、MSSQL、BigQuery、Oracle Database、SQLite、ElasticSearch
• 🌍 支持多种协议 – 提供 REST 或 MCP 服务 API，包括 SSE 模式
• 🔐 身份验证选项 – 内置支持 API 密钥和 OAuth
• 🔒 PII 保护 – 使用 正则表达式插件或 Microsoft Presidio 插件，对 PII 和敏感数据进行脱敏
• 👀 全面监控 – 集成 OpenTelemetry (OTel)，用于请求跟踪和审计追踪
• 📦 本地和本地部署 – 通过可配置的 AI 端点和模型支持 可自托管的大模型
• 🤖 支持多种 AI 提供商 - 支持 OpenAI、Anthropic、Amazon Bedrock、Google Gemini 和 Google VertexAI
• ⚡ 灵活配置 – 通过 YAML 配置和插件系统轻松扩展
• 📜 API 文档 – 自动生成 Swagger 文档和 OpenAPI 3.1.0 规范
• 🔑 行级安全 (RLS) – 使用 Lua 脚本进行精细化数据访问控制
• 🏎️ 性能优化 – 实现基于时间的缓存和 LRU 缓存策略

工作原理

1. 连接与发现

Gateway 连接到 PostgreSQL 等结构化数据库，并自动分析表结构和数据样本， 根据提示词生成经过优化的 API 结构。大模型仅在发现阶段用于生成 API 配置。 该工具使用 AI Providers 生成 API 配置，同时通过 PII 检测确保安全。

2. 部署

Gateway 支持多种部署方式，包括独立二进制文件、Docker 或 Kubernetes。 请查看我们的启动指南，了解详细 说明。系统使用 YAML 配置和插件，便于自定义。

3. 使用与集成

通过 REST API 或 Model Context Protocol（MCP）访问数据，并使用内置安全功能。 Gateway 可通过函数调用与 LangChain、 OpenAI 和 Claude Desktop 等 AI 模型和应用无缝集成， 也可通过 MCP 与 Cursor 集成。你还可以设置遥测，将数据发送到本地或远程目标，格式为 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 使用大模型生成 API 配置。请按以下步骤操作：

选择一个受支持的 AI 提供商：

• OpenAI 及所有兼容 OpenAI 的提供商
• Anthropic
• Amazon Bedrock
• Google Vertex AI（Anthropic）
• Google Gemini

Google Gemini 提供慷慨的免费额度。你可以访问 Google AI Studio 获取 API 密钥：

• Google AI Studio

登录后，你可以在 AI Studio 的 API 部分创建 API 密钥。免费额度包含充足的月度令牌额度，便于开发和测试。

配置 AI 提供商授权。对于 Google Gemini，请设置 API 密钥。

export GEMINI_API_KEY='yourkey'

2. 运行发现命令：

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

3. 等待生成过程完成：

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

4. 在 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

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

MCP 协议集成

Gateway 实现了 MCP 协议，可与 Claude 和其他工具无缝集成。详细设置说明请参阅我们的 Claude 集成指南。

要将 MCP 工具添加到 Claude Desktop，只需调整 Claude 的配置：

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

路线图

路线图可能随时变更，并将很大程度上取决于用户反馈。目前， 我们计划推出以下功能：

数据库与连接

• 🗄️ 扩展数据库集成 - Databricks、Redshift、S3（Iceberg 和 Parquet）、Oracle DB、Microsoft SQL Server、Elasticsearch
• 🔑 SSH 隧道 - 支持使用跳板机或 SSH 堡垒机建立隧道连接

功能增强

• 🔍 高级查询能力 - 复杂筛选语法和作为参数的聚合函数
• 🔐 增强 MCP 安全性 - API 密钥和 OAuth 身份验证

平台改进

• 📦 架构管理 - 自动化架构演进和 API 版本控制
• 🚦 高级流量管理 - 智能速率限制、请求节流
• ✍️ 写入操作支持 - 插入、更新操作

MCP 注册目录中的数据库网关

• https://mcpreview.com/mcp-servers/centralmind/gateway
• https://mcp.so/server/gateway/centralmind
• https://smithery.ai/server/@centralmind/gateway
• https://www.pulsemcp.com/servers/centralmind-database-gateway