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倉庫
• 🛠️ 技術支持：幫助中心