deco Studio

deco Studio 是一个开源的 AI Agent 控制平面，核心围绕 Model Context Protocol (MCP) 构建。它提供 Agent 商店（浏览、雇佣、组合 Agent）、50+ 工具一键 OAuth 连接、Token Vault 凭证集中管理、Virtual MCPs（Full-context / Smart selection / Code execution 三种模式）等能力。在可观测性方面，支持按连接和 Agent 维度追踪 Token 消耗、延迟百分位与错误率，集成 OpenTelemetry。项目组织采用声明式规划引擎，定义结果后由 Studio 反向推导里程碑并分配 Agent（当前实现深度待确认，Roadmap 中列为未来项）。多租户基于 Better Auth 实现 RBAC，Workspace/Project 级隔离配置、凭证与审计日志。内置事件总线支持连接间 Pub/Sub 和定时投递（At-least-once）。底层基于 Bun 运行时，Hono 后端 + React 19 前端，Kysely 数据库层，工具通过 defineTool + Zod Schema 声明式定义并自动获得校验、鉴权、审计与追踪。支持一键安装（bunx decocms）、Docker、Kubernetes (Helm) 多种部署方式，数据可完全自托管。当前处于 Public Beta 阶段，采用 Sustainable Use License (SUL)，内部使用和客户项目免费，SaaS/商业化需商业授权。

安装与部署#

bunx decocms

从源码运行：

git clone https://github.com/decocms/studio.git
bun install
bun run dev

Docker 部署（内嵌 PostgreSQL）：

docker compose -f deploy/docker-compose.yml up

Docker 部署（外部 PostgreSQL）：

docker compose -f deploy/docker-compose.postgres.yml up

Kubernetes（Helm）：

helm install deco-studio oci://ghcr.io/decocms/chart-deco-studio --version <version> -n deco-studio --create-namespace

生产构建：

bun run build:client && bun run build:server && bun run start

自定义工具定义示例#

import { z } from "zod";
import { defineTool } from "~/core/define-tool";

export const CONNECTION_CREATE = defineTool({
  name: "CONNECTION_CREATE",
  description: "Create a new MCP connection",
  inputSchema: z.object({
    name: z.string(),
    connection: z.object({
      type: z.enum(["HTTP", "SSE", "WebSocket"]),
      url: z.string().url(),
      token: z.string().optional(),
    }),
  }),
  outputSchema: z.object({
    id: z.string(),
    scope: z.enum(["workspace", "project"]),
  }),
  handler: async (input, ctx) => {
    await ctx.access.check();
    const conn = await ctx.storage.connections.create({
      projectId: ctx.project?.id ?? null,
      ...input,
      createdById: ctx.auth.user!.id,
    });
    return { id: conn.id, scope: conn.projectId ? "project" : "workspace" };
  },
});

待确认信息#

• 声明式规划引擎在 Roadmap 中列为未来项，当前实际实现深度待确认
• 官网提及 SQLite，但项目结构显示使用 Kysely → PostgreSQL，两者存在矛盾
• Agent 商店实际可雇佣的 Agent 数量和种类未在公开资料中明确列出
• SUL 商业授权具体价格和条款需查看 LICENSE.md
• 组织名 decocms 与产品名 deco Studio 的完整产品矩阵关系未完全明确