gateway

🚀 中央心智网关文档

中央心智网关借助大语言模型生成API配置文件，具备支持多种数据库连接的能力，并拥有一系列高级功能，能有效提升数据处理与交互的效率和安全性。

✨ 主要特性

数据发现与建模

• 📋 数据表自动识别：可识别PostgreSQL、Redshift等多种数据库中的表结构。
• 🔍 列类型推断：自动推断数值型、日期时间、字符串等数据类型。
• 🛡️ PII检测：识别敏感字段如信用卡号、社会安全码，并在生成API时进行脱敏处理。

安全特性

• 🔒 访问控制：支持基于IP白名单和JWT的认证授权机制。
• 🚫 速率限制：默认支持每秒请求限制（QPS），防止滥用攻击。
• 📝 审计日志：记录所有API调用，包括用户信息、操作类型和响应状态码。

高级功能

• 📡 协议支持：同时支持HTTP REST和MCP协议，可与Claude等工具无缝集成。
• 🙈 数据脱敏：对敏感字段自动应用脱敏规则，如掩码处理。
• 🗃️ 多版本支持：支持在同一配置文件中定义多个API版本。

🚀 快速开始

💻 代码运行示例

# 安装依赖
go mod download

# 运行网关
./gateway start --config gateway.yaml

🐳 Docker部署示例

# Docker Compose配置
version: '3'
services:
  gateway:
    build: .
    ports:
      - "8080:8080"
    environment:
      - GEMINI_API_KEY=yourkey

📚 详细文档

📋 API生成指南

步骤1：选择AI提供方

支持以下几种：

• OpenAI及兼容提供方
• Anthropic
• Amazon Bedrock
• Google Vertex AI (Anthropic)
• 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.

🚀 运行指南

🏠 本地运行

./gateway start --config gateway.yaml

🐋 Docker Compose部署

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

🔌 MCP协议集成

在Claude配置文件中添加：

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

🗺️ 路线图

📅 计划功能

• 📊 扩展数据库支持：Redshift、S3（Parquet格式）、Snowflake等。
• 🔐 增强安全性：引入细粒度访问控制和动态脱敏。
• ⚙️ 性能优化：提升复杂查询处理速度，降低延迟。

📚 其他资源

• 🌐 官方文档：中央网关文档
• 💻 示例代码：GitHub仓库
• 🛠️ 技术支持：帮助中心