Agent Swarm

Name: Agent Swarm
Author: desplega-ai

作者：desplega-ai版本 2.8.2i★ –i电脑或云端

注册名称io.github.desplega-ai/agent-swarm

安装

概览

作者提供的说明（英文原文）

Full Agent Swarm API and MCP server with local SQLite storage for multi-agent orchestration.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i正在增长↓ 3214/周 · ★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 电脑或云端
传输方式: Streamable HTTP
分类: 数据库与数据集
你需要填写：AGENT_SWARM_API_KEY, Authorization

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在作者的服务器上运行：你向它提出的内容会经过他们的服务器。
需要你自己填写： AGENT_SWARM_API_KEY, Authorization

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

在云端运行无需安装任何东西，通过互联网连接
npm已安装 Node.js（用于 npx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

这个地址需要在请求的 header 中放入密钥，而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。

或者在你的电脑上运行

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "agent-swarm": {
      "command": "npx",
      "args": [
        "-y",
        "@desplega.ai/agent-swarm",
        "api",
        "--port",
        "3000"
      ],
      "env": {
        "AGENT_SWARM_API_KEY": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add --transport http agent-swarm 'https://{swarm_host}/mcp-user' --header 'Authorization: your-value'

或者在你的电脑上运行

claude mcp add agent-swarm --env AGENT_SWARM_API_KEY=your-value -- npx -y @desplega.ai/agent-swarm api --port 3000

运行前请先填写空着的值。

地址中有只有你知道的 {…} 部分（例如你的账户），请复制后自行填写。

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-swarm": {
      "url": "https://{swarm_host}/mcp-user",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

或者在你的电脑上运行

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-swarm": {
      "command": "npx",
      "args": [
        "-y",
        "@desplega.ai/agent-swarm",
        "api",
        "--port",
        "3000"
      ],
      "env": {
        "AGENT_SWARM_API_KEY": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

地址中有只有你知道的 {…} 部分（例如你的账户），请复制后自行填写。

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "agent-swarm": {
      "type": "http",
      "url": "https://{swarm_host}/mcp-user",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

或者在你的电脑上运行

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "agent-swarm": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@desplega.ai/agent-swarm",
        "api",
        "--port",
        "3000"
      ],
      "env": {
        "AGENT_SWARM_API_KEY": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个地址需要在请求的 header 中放入密钥，而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

AGENT_SWARM_API_KEY 机密必填 env
API key for your local Agent Swarm instance.
Authorization 机密必填 HTTP header
Bearer aswt_ for an active user on your swarm. Ask a swarm operator to mint it in People > your user > Tokens, or via POST /api/users/{id}/mcp-tokens. Copy the plaintext when minted (shown once). Inc…

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

这个地址需要填入你自己的值，所以我们无法替你读取工具列表。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月10日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 desplega-ai 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
这个地址需要填入你自己的账户信息，所以我们无法替你检查
– 不适用
使用 OAuth 登录
这个地址需要填入你自己的账户信息，所以我们无法替你检查
… 尚未检查
工具描述中没有隐藏指令
尚未检查；我们会在检查端点时读取工具列表

与“数据库与数据集”中的其他服务器比较i

星标数多于此分类中其他 1158 个服务器的 0%
发布到注册中心的时间比此分类中其他 1158 个服务器的 91% 更新
基础检查结果等于或优于此分类中其他 1158 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Agent Swarm 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：AGENT_SWARM_API_KEY, Authorization

它在我的电脑上运行还是在云端？

两种方式都可以：安装在你的电脑上，或者连接云端版本。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（2.8.2）于4天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接，所以接受远程 MCP 服务器的应用也可以使用，例如开启开发者模式的 ChatGPT。

有什么可以替代它？

同一分类中有：Supabase, MongoDB MCP Server, Elasticsearch MCP Server

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Supabase

MCP server for interacting with the Supabase platform

作者：supabase广泛使用↓ 23.5万/周★ 29933天前更新

电脑或云端✓ supabase.com

安装

MongoDB MCP Server

MongoDB Model Context Protocol Server

作者：mongodb-js广泛使用↓ 15.7万/周★ 1157今天更新

在你的电脑上运行

安装

Elasticsearch MCP Server

MCP server for interacting with Elasticsearch

作者：cr7258正在增长↓ 2711/周★ 31514个月前更新

在你的电脑上运行

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Agent Swarm is the open-source, self-hosted AI company operating system built by Desplega Labs .

[!TIP]

This repo evolves every single day. Watch now →

▸ every team, one swarm · daily evolution · Making of

agent-swarm.dev is an open-source operating system for AI work. A lead agent delegates goals to workers such as Claude Code or Codex. Isolated containers, shared memory, tools, schedules, and review gates preserve work across sessions.

What you get

A lead agent that receives work from Slack, repositories, issue trackers, email, or the API
Schema-validated task results for callers that need structured JSON output
Deferred tasks that wake when all or any watched tasks reach an outcome, or a deadline arrives
Inline tool-result images in task logs, with previews that open at full size
Dashboard file attachments by paste, drag-and-drop, or file picker
Workers in isolated Docker containers with development environments
Memory and identity that persist across sessions, with citation ratings and self-rating hints enabled by default
Workflows, schedules, scripts, and apps for recurring work
Extensions for trusted TypeScript hooks, installed as agent-owned inert drafts and activated by a trusted lead, operator, or dashboard user
Realtime rooms for shared page state, presence, and live channels
Your choice of harness and models: Claude Code, Codex, pi, opencode, Cursor, Amp, Grok, fx, Devin, or ACP agents

flowchart LR

subgraph IN["Tasks come in"] direction TB S["Slack"] G["GitHub / GitLab"] E["Email"] A["API / CLI"] end

LEAD(["Lead Agent plans & delegates"])

subgraph WORKERS["Workers in Docker"] direction TB W1["Worker"] W2["Worker"] W3["Worker"] end

subgraph BRAIN["Persistent brain"] direction TB MEM["Memory (vector search)"] ID["Identity (SOUL, CLAUDE.md)"] end

subgraph OUT["Work ships"] direction TB PR["Pull Requests"] REPLY["Slack replies"] EMAIL["Email replies"] end

IN --> LEAD --> WORKERS WORKERS -->|reads context| BRAIN WORKERS -->|writes learnings| BRAIN WORKERS --> OUT

Quick Start

Give your coding agent the operator skill for Docker Compose or Kubernetes:

npx skills add desplega-ai/agent-swarm

Or install it as a plugin in your harness:

Harness	Command
Claude Code	`/plugin marketplace add desplega-ai/agent-swarm` then `/plugin install agent-swarm@agent-swarm`
Codex	`codex plugin marketplace add desplega-ai/agent-swarm && codex plugin add agent-swarm@agent-swarm` (or use `npx skills` above)
Cursor	`/add-plugin desplega-ai/agent-swarm`
Gemini CLI	`gemini extensions install https://github.com/desplega-ai/agent-swarm`
Antigravity / Factory Droid	`droid plugin marketplace add https://github.com/desplega-ai/agent-swarm` then `droid plugin install agent-swarm@agent-swarm`
OpenCode, pi, Devin, Kimi, others	`npx skills add desplega-ai/agent-swarm`

The plugin's privacy and terms links describe the Agent Swarm website and Cloud service. The self-hosted software remains covered by the MIT License.

Or self-host. docker-compose.example.yml is the reference deployment: deploy every agent in it by default (1 lead and 11 workers on the official templates), and remove agents only when you have a reason to.

Plan for at least 4 vCPU, 8 GB RAM and 40 GB of free disk, and prune old Docker images after upgrades. See Host requirements & disk cleanup.

The one-shot installer checks Docker and Compose v2, installs Bun when missing, runs agent-swarm onboard --yes --preset full (every official template; it runs one coder where the example runs two), and prints the dashboard /setup link:

curl -fsSL https://agent-swarm.dev/install.sh | bash

The raw GitHub URL (https://raw.githubusercontent.com/desplega-ai/agent-swarm/main/install.sh) serves the same script. The API is public through a tunnel by default, protected by the API key. Add bash -s -- --no-tunnel to keep it local.

No server yet? Deploy the Railway template in one click:

Or deploy one on any VPS: paste deploy/cloud-init.yaml as the user data of a new 4 vCPU / 8 GB Ubuntu server (Hetzner, DigitalOcean, Lightsail, Vultr). It installs Docker and Caddy, serves the API over HTTPS on .sslip.io or your domain, and shows the /setup link to root at login. To look first, try it for an hour on E2B; that trial deletes its data when the sandboxes stop.

Or use the examples directly:

git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm

cp .env.docker.example .env # Set API_KEY and the credential for your HARNESS_PROVIDER. openssl rand -base64 32 > encryption_key chmod 600 .env encryption_key docker compose -f docker-compose.example.yml --env-file .env up -d

Agent ID variables are optional. Each container generates a UUID on first boot and keeps it in its personal volume, so identity survives restarts. Pin *_AGENT_ID in .env only to keep an existing identity or to survive removing volumes.

Read the Compose checklist before starting. API: http://localhost:3013, with /docs and /openapi.json. Next, open the dashboard and connect it to your API with API_KEY. A new install lands on /setup, a guided first run that covers providers, agents, memory, integrations, and a first task. Kubernetes: install the OCI Helm chart.

Integrations

Slack · GitHub · GitLab · Azure DevOps · Linear · Jira · AgentMail · WhatsApp (Kapso) · Telegram, Teams and Discord (Chat SDK) · Composio · Sentry · Devin · Serply search. Integration guides.

AgentMail archives verified inbound deliveries before acknowledging them and retains the archive for 30 days, including mail excluded from task routing. See the contact inbox triage runbook for retention, coverage limits, and rollout instructions.

Learn more

Getting started · Architecture · Playbooks · CLI · API reference
Orchestration patterns — Five patterns for delegating, fanning out, gating on humans, retrying, and persisting multi-step agent work
Agent templates
Public ranking: opt in with Get ranked (Settings → Configuration → Branding) to rank your install by tokens used on agent-swarm.dev/ranking. It shows at the next hourly refresh. Token totals are public and exact; telemetry, the organization name and website must be set.
Help: contact@desplega.sh · Discord

Contributing

Read CONTRIBUTING.md, fork the repository, create a branch, and open a PR. Discuss ideas on Discord.

Are you an agent? Run npx skills add desplega-ai/agent-swarm or read the operator skill.

Star History

License

MIT · 2025-2026 desplega.sh

Feature defaults

Fresh deployments enable Slack thread renderer v2, queued Slack steering to the lead, task steering, multi-runtime workers, RBAC, and task-tool preloading. Hybrid memory search and graph expansion are also enabled. Explicit environment/config overrides remain supported; see the environment reference. When upgrading older workers, keep MULTI_RUNTIME_ENABLED=false until they support runtime identities. Slack delegation rende

只显示了开头部分；其余内容请在仓库中阅读

Agent Swarm

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

或者在你的电脑上运行

或者在你的电脑上运行

或者在你的电脑上运行

或者在你的电脑上运行

需要你填写的值

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“数据库与数据集”中的其他服务器比较i

常见问题

替代选择

Supabase

MongoDB MCP Server

Elasticsearch MCP Server

作者的 README

What you get

Quick Start

Integrations

Learn more

Contributing

Star History

License

Feature defaults