DataNexus 后端

企业AI统一数据网关平台后端服务，提供 MCP 协议 + HTTP REST API 双出口能力。

技术栈

• Python 3.11+
• FastAPI + Uvicorn
• SQLAlchemy 2.0 (async) + PostgreSQL
• 官方 MCP Python SDK
• Pydantic V2

环境管理

本项目使用 uv 管理 Python 环境和依赖。

初始化环境

cd backend
uv venv
uv pip install -e ".[dev]"

运行服务

uv run uvicorn app.main:app --reload --port 8000

运行测试

uv run pytest -v

项目结构

backend/
├── app/
│   ├── main.py          # FastAPI 入口
│   ├── core/            # 核心配置（settings、数据库、安全）
│   ├── models/          # SQLAlchemy 数据模型
│   ├── schemas/         # Pydantic 请求/响应模型
│   ├── services/        # 核心业务逻辑（双出口共用）
│   ├── api/             # HTTP REST API 路由
│   ├── mcp/             # MCP 协议出口
│   ├── datasource/      # 多数据源连接池管理
│   └── middleware/      # 中间件（限流等）
├── tests/               # 测试
├── pyproject.toml       # 项目配置
└── Dockerfile

API 端点

路径	说明
GET /health	健康检查
POST /api/v1/auth/login	用户登录
GET /api/v1/datasources	数据源列表
POST /api/v1/datasources	创建数据源
GET /api/v1/metadata/tables/{id}	获取表列表
GET /api/v1/metadata/columns/{id}	获取字段列表
POST /api/v1/query/execute	执行SQL查询
GET /api/v1/audit/logs	审计日志查询

MCP 工具

工具名	说明
get_database_schema	获取数据库元数据
query_database	安全SQL查询（仅SELECT）
call_custom_api	调用封装的内部API

环境变量

参考 .env.example 配置 .env 文件。