API、SDK、CLI 与 MCP

生产 API 为 https://api.drapub.com，本地为 http://127.0.0.1:4320。工作区、认证和权限由 Go Backend 校验。

CLI

# From the repository root
bun run cli --help
bun run cli workspace list
bun run cli kb list
bun run cli api /v1/knowledge-bases
bun run cli mcp serve

设置 DRAPUB_API_BASE_URL、DRAPUB_API_KEY 或 DRAPUB_TOKEN、DRAPUB_WORKSPACE_ID，也可通过 drapub auth login 配置。脚本检查退出码；写操作遵守审核与幂等约束。旧 Bun CLI 命令已退役，不是新命令的别名。未封装的接口通过 drapub api 调用。

TypeScript SDK

import { createDraPubRestClient } from "@drapub/sdk/go-api";

const client = createDraPubRestClient({
  baseUrl: "https://api.drapub.com",
  getToken: async () => currentSessionToken,
  getWorkspaceId: () => currentWorkspaceId,
  fetchImpl: fetch,
});
const knowledgeBases = await client.get<unknown>("/v1/knowledge-bases");

示例中的会话与工作区由调用方注入。优先使用 SDK 的 operation 方法及 Go 生成类型；go-agent 子入口提供会话流。浏览器不能嵌入长期 API Key。独立 Go SDK 位于 apps/drapub-client。

MCP / Skillpack

drapub mcp serve 提供知识库、文档、检索与对话工具；对话工具会创建会话或消息。bun run skillpack:check 检查载荷，bun run skillpack:install:local 安装到本地 Agent。客户端只访问 API，不访问业务数据库。