跳转至
开源项目 · SQLModel · Python 3.10+

从模型到 API,渐进式开发

SQLModel 实体驱动 GraphQL API、REST DTO 和 MCP 服务——一套模型,多种呈现。

pip install sqlmodel-nexus

SQLModel + @query = GraphQL API

面向开发验证 —— 快速验证实体关系和数据结构。

手写 GraphQL schema + resolver
# Write SDL by hand
type Query {
  posts(limit: Int): [Post]!
}
type Post {
  id: Int!
  title: String!
  author: User
}
# + resolver + DataLoader + N+1 fix
 # Dozens of lines of boilerplate
使用 sqlmodel-nexus
class Post(SQLModel, table=True):
    id: int | None = Field(primary_key=True)
    title: str
    author_id: int = Field(foreign_key="user.id")
    author: User | None = Relationship()

    @query
    async def get_all(cls, limit: int = 10) -> list['Post']: ...
 # SDL + DataLoader auto-generated!

DefineSubset + 隐式自动加载 = REST DTO

面向生产数据对接 —— 用类型化 DTO 构建稳定的 REST 端点。

手写查询 + 手动拼装
# Per-endpoint: manual SQL, N+1, dict munging
async def get_sprints():
    sprints = await session.exec(select(Sprint))
    result = []
    for s in sprints:
        tasks = await session.exec(
            select(Task).where(Task.sprint_id == s.id))
        for t in tasks:
            t.owner = await session.get(User, t.owner_id)
 # N+1 queries, fragile dict construction
声明式 DTO + 自动加载
class UserDTO(DefineSubset):
    __subset__ = (User, ("id", "name"))

class TaskDTO(DefineSubset):
    __subset__ = (Task, ("id", "title", "owner_id"))
    owner: UserDTO | None = None   # auto-loaded

class SprintDTO(DefineSubset):
    __subset__ = (Sprint, ("id", "name"))
    tasks: list[TaskDTO] = []      # auto-loaded

 # 1 query per relationship, zero N+1

从模型到生产,一站式工具

ER 图、GraphQL、REST DTO 和 MCP,全部由 SQLModel 实体驱动。

ER 图

SQLModel 实体 + 非 ORM 关系,一键生成 Mermaid ER 图。

GraphQL 自动生成

@query / @mutation 装饰器自动生成 SDL,内置 DataLoader 批量加载。

Core API DTO

DefineSubset + 隐式自动加载,声明式构建 REST 响应。

派生字段与跨层

post_* 计算派生字段,ExposeAs / SendTo 实现跨层数据流。

MCP 集成

通过 MCP 协议将 SQLModel API 暴露给 AI 代理。

RPC 服务

业务逻辑定义为 RpcService,同时服务于 MCP 和 FastAPI。

渐进式开发路径

从实体开始,按需扩展。每个阶段都建立在前一个之上。

1 SQLModel 实体
2 ER 图
3 GraphQL API
4 Core API DTO
5 MCP / RPC

为你的技术栈而建

与你现有的框架和工具无缝集成。

准备好从模型到 API 了吗?

从一个 @query 装饰器开始,准备好了再扩展到全栈。