defineAPI() 一次。
四種協議。 think() remember() 已內建。

在同一個 handler 裡混合業務邏輯與 AI 推理。HTTP、MCP、A2A、OpenAPI — 自動生成。

$ bunx create-capstan-app my-app

一個 defineAPI() 定義自動建立: HTTP JSON API (Hono), MCP 工具 (Claude Desktop), A2A 技能 (Google Agent-to-Agent), OpenAPI 3.1 規範.

app/routes/tickets/index.api.ts
import { defineAPI } from "@zauso-ai/capstan-core";
import { z } from "zod";

export const GET = defineAPI({
  input: z.object({
    status: z.enum(["open", "closed"]).optional(),
  }),
  output: z.object({
    tickets: z.array(z.object({
      id: z.string(),
      title: z.string(),
      status: z.string(),
    })),
  }),
  description: "List support tickets",
  capability: "read",
  resource: "ticket",
  async handler({ input }) {
    return { tickets: await db.tickets.list(input) };
  },
});

為什麼選擇 Capstan

多協議 API

一個 defineAPI() 同時暴露 HTTP、MCP、A2A 和 OpenAPI 端點。

AI 智慧體工具包

think()、generate()、帶工具呼叫的 agent loop。獨立套件 @zauso-ai/capstan-ai。

長期記憶

remember/recall/about 維度隔離。自動去重、混合檢索、上下文組裝。

串流 SSR

React 18 renderToReadableStream,選擇性 hydration,Image/Font/Metadata。

安全與身份

JWT、OAuth、DPoP (RFC 9449)、SPIFFE/mTLS、限流、CSRF。

資料庫與 RAG

Drizzle ORM、向量欄位、嵌入、混合搜尋、4 種資料庫支援。

快取與 ISR

cacheSet/cacheGet,TTL、標籤、stale-while-revalidate。

EU AI Act 合規

defineCompliance 風險分級、稽核日誌、核准工作流程。

框架比較

功能CapstanNext.jsFastAPI
Multi-protocol (HTTP + MCP + A2A)+
OpenAPI auto-generation++
File-based routing++
React SSR++
Built-in auth (JWT + API keys)+~
Policy engine + approval workflow+
AI TDD verifier+
Built-in database layer+
AI Agent Toolkit+
Long-term Memory+
LLM Integration+~~
Cache / ISR++

+ 內建 ~ 部分 不可用 | 完整比較

快速開始

  1. 建立
    bunx create-capstan-app my-app
  2. 開發
    cd my-app && bunx capstan dev
  3. 連線

    你的應用已上線,所有 agent 端點就緒:

    # Agent manifest
    curl http://localhost:3000/.well-known/capstan.json
    
    # OpenAPI spec
    curl http://localhost:3000/openapi.json
    
    # MCP server (for Claude Desktop / Cursor)
    bunx capstan mcp

獨立 AI 工具包

@zauso-ai/capstan-ai 無需完整框架即可使用。可在任何 TypeScript 專案中用於結構化 LLM 互動和持久記憶。

import { createAI } from "@zauso-ai/capstan-ai";

const ai = createAI({ llm: openaiProvider({ apiKey: "..." }) });
await ai.think("Analyze this data");
await ai.remember("User prefers dark mode");
const context = await ai.memory.about("customer", "c-42").recall("preferences");

瀏覽文件

MIT 授權 · 基於 Capstan 建構 — 同時服務人類與機器的 API。