Swarms Logo
指南产品

Swarms Skills:在 Claude Code、Codex、VS Code 及任意智能体中使用 Swarms Marketplace

Swarms Marketplace 现已以智能体技能(Skills)和插件的形式发布。通过 skills.sh、Claude Code 或 Codex 一条命令即可安装,也可以将 Swarms Marketplace MCP 服务器接入 VS Code、Cursor、Claude Desktop 以及你自己的智能体。本教程涵盖所有接入方式,并附上可直接复制的示例。

Kye Gomez10 分钟阅读
Swarms Skills:在 Claude Code、Codex、VS Code 及任意智能体中使用 Swarms Marketplace

Swarms Marketplace 收录了 6,000 多个 AI 智能体、提示词、工具和 MCP 服务器。在此之前,想在编程智能体中使用它,需要手动配置 MCP 服务器或阅读 API 文档。今天我们发布 Swarms Skills:一个开源软件包,只需一条安装命令,就能把 Swarms Marketplace 带进开发者已经在用的智能体里。

Swarms Skills 托管在 github.com/The-Swarm-Corporation/swarms-skills,采用 Apache-2.0 许可证。它支持 skills.sh、Claude Code、Codex、VS Code、Cursor、Claude Desktop,以及任何支持模型上下文协议(MCP)的客户端。

本文是一篇教程,会逐一介绍每种接入方式,并提供可直接复制的示例。

本次发布包含什么

这个仓库包含三部分:

  • 两个智能体技能:
    • swarms-marketplace-mcp 教你的智能体如何使用 Swarms Marketplace MCP 服务器,涵盖连接、认证、全部工具、返回格式和错误处理。
    • swarms-marketplace-api 介绍 REST API,包括智能体、提示词、代币化和手续费领取。
  • 适用于 Claude Code 和 Codex 的插件: 一步安装两个技能,并连接位于 https://swarms.world/mcp 的 MCP 服务器。
  • 插件市场清单: 你可以把这个仓库添加为 Claude Code 和 Codex 的插件来源,并随时获取我们发布的更新。

技能是一组指令,只有在相关时才会被智能体加载。当你提出 Swarms Marketplace 能够解答的需求时,智能体会读取技能、了解 Swarms Marketplace 的用法,并调用正确的工具。

你的智能体能做什么

安装完成后,你的智能体可以:

  • 为当前任务找到合适的智能体、提示词或工具。 按名称、类别、标签或价格搜索,并对比不同选项。
  • 完整读取商品内容。 免费智能体会返回可直接运行的源代码,免费提示词会返回完整正文,可以直接放进你的项目。
  • 查看价格和评价,再决定是否购买付费商品。
  • 发布和更新你自己的产品。 发布智能体、提示词和捆绑包,并编辑你名下的商品。
  • 撰写评价,管理你的商品和创作者手续费。

所有操作都以你的账户身份、通过你的 Swarms API 密钥执行。

开始之前:获取 API 密钥

浏览工具列表无需密钥,但调用工具需要 Swarms API 密钥。

  1. 登录 swarms.world。
  2. 打开 swarms.world/platform/api-keys 并创建一个密钥。
  3. 在终端中导出密钥,方便下面的示例读取:
Shell
export SWARMS_API_KEY="sk-..."

请像对待密码一样保管密钥。每一次工具调用都会以密钥所属账户的身份执行。

方式一:任意智能体,通过 skills.sh

skills.sh 是一个开放的智能体技能目录和命令行工具。一条命令即可把两个 Swarms 技能安装到你的项目中:

Shell
npx skills add The-Swarm-Corporation/swarms-skills

该命令会把技能复制到 .agents/skills/(许多智能体都会读取这个共享目录),并为检测到的智能体(例如 Claude Code)创建链接。skills-lock.json 会记录技能的来源,方便日后更新。

常用变体:

Shell
# 为这台机器上的所有项目安装,而不只是当前项目
npx skills add The-Swarm-Corporation/swarms-skills -g

# 只安装 MCP 技能
npx skills add The-Swarm-Corporation/swarms-skills --skill swarms-marketplace-mcp

# 为指定的智能体安装
npx skills add The-Swarm-Corporation/swarms-skills -a claude-code

技能告诉智能体如何使用 Swarms Marketplace。要让它真正调用 Swarms Marketplace,还需要按下面任一方式连接 MCP 服务器,或者直接使用插件(两者兼得)。

方式二:Claude Code

安装插件(推荐)

插件会安装两个技能并连接 MCP 服务器。在 Claude Code 会话中运行:

/plugin marketplace add The-Swarm-Corporation/swarms-skills /plugin install swarms-marketplace@swarms

启用插件时,Claude Code 会请你输入 Swarms API 密钥,并把它保存在系统的安全凭据存储中,密钥不会出现在任何配置文件里。

也可以在终端中完成同样的操作:

Shell
claude plugin marketplace add The-Swarm-Corporation/swarms-skills
claude plugin install swarms-marketplace@swarms

或者只连接 MCP 服务器

如果你只需要工具,可以直接添加服务器:

Shell
claude mcp add --transport http swarms https://swarms.world/mcp \
  --header "Authorization: Bearer $SWARMS_API_KEY"

在会话中运行 /mcp 确认连接成功。工具会以 mcp__swarms__<tool> 的形式出现,例如 mcp__swarms__get_get-agents。

试一试

用自然语言向 Claude Code 提问:

在 Swarms Marketplace 上找三个免费的研究类智能体,并比较它们的功能。
获取 swarms.world 上最受欢迎的、用于编写技术文档的免费提示词的完整内容。
把 ./agents/summarizer.py 中的智能体以免费智能体的形式发布到 Swarms Marketplace 的 Research 类别。

方式三:Codex

安装插件

把这个仓库添加为 Codex 的插件市场:

Shell
codex plugin marketplace add The-Swarm-Corporation/swarms-skills

然后在 Codex 中打开插件列表,安装 Swarms Marketplace,并在提示时输入你的 Swarms API 密钥。插件会同时带来两个技能和 MCP 服务器。

或者只连接 MCP 服务器

在 ~/.codex/config.toml 中添加服务器。Codex 会从你指定的环境变量中读取密钥,因此密钥不会写进文件:

TOML
[mcp_servers.swarms]
url = "https://swarms.world/mcp"
bearer_token_env_var = "SWARMS_API_KEY"

导出 SWARMS_API_KEY 后启动 Codex,然后像在 Claude Code 中一样让它搜索 Swarms Marketplace。

方式四:VS Code

swarms-skills 的 README 中有一个 Install in VS Code 按钮。点击后会添加服务器,并在隐藏输入框中请你填写密钥。

如果想手动配置,或者通过代码仓库与团队共享,可以创建 .vscode/mcp.json:

JSON
{
  "inputs": [
    {
      "type": "promptString",
      "id": "swarms-api-key",
      "description": "Swarms API key (https://swarms.world/platform/api-keys)",
      "password": true
    }
  ],
  "servers": {
    "swarms": {
      "type": "http",
      "url": "https://swarms.world/mcp",
      "headers": {
        "Authorization": "Bearer ${input:swarms-api-key}"
      }
    }
  }
}

服务器首次启动时,VS Code 会请你输入密钥并安全保存。之后即可在 Copilot 的智能体模式中使用 Swarms Marketplace 的工具。

方式五:Cursor

把服务器添加到项目中的 .cursor/mcp.json,或者添加到 ~/.cursor/mcp.json 让所有项目都能使用:

JSON
{
  "mcpServers": {
    "swarms": {
      "url": "https://swarms.world/mcp",
      "headers": { "Authorization": "Bearer sk-..." }
    }
  }
}

如果文件中包含密钥,请不要把它提交到版本控制。

方式六:Claude Desktop 及其他 stdio 客户端

只能启动本地服务器的客户端,可以通过 mcp-remote 桥接访问 Swarms Marketplace:

JSON
{
  "mcpServers": {
    "swarms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://swarms.world/mcp",
        "--header",
        "Authorization: Bearer sk-..."
      ]
    }
  }
}

在 Claude Desktop 中,这段配置放在 claude_desktop_config.json 里。保存后重启应用。

方式七:你自己的智能体

同一个服务器也可以在代码中使用。每个工具都以文本形式返回 JSON,解析第一个内容块即可。

Python

使用官方 mcp SDK(2.x):

Python
import asyncio, json, os
import httpx2
from mcp import ClientSession
from mcp.client.streamable_http import streamable_http_client

URL = "https://swarms.world/mcp"
HEADERS = {"Authorization": f"Bearer {os.environ['SWARMS_API_KEY']}"}

async def main():
    async with httpx2.AsyncClient(headers=HEADERS, timeout=60) as http:
        async with streamable_http_client(URL, http_client=http) as streams:
            async with ClientSession(streams[0], streams[1]) as session:
                await session.initialize()

                tools = await session.list_tools()
                print([t.name for t in tools.tools])

                result = await session.call_tool(
                    "get_get-prompts", {"limit": 5, "is_free": True, "name": "research"}
                )
                page = json.loads(result.content[0].text)
                for row in page["data"]:
                    print(row["id"], row["name"])

asyncio.run(main())

如果使用 mcp 1.x,请改为导入 streamablehttp_client,并直接向它传入 headers=。

TypeScript

使用 @modelcontextprotocol/sdk:

ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://swarms.world/mcp"),
  { requestInit: { headers: { Authorization: `Bearer ${process.env.SWARMS_API_KEY}` } } },
);

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

const { tools } = await client.listTools();
console.log(tools.map((t) => t.name));

const result = await client.callTool({
  name: "get_get-agents",
  arguments: { limit: 3, category: "Finance" },
});
const page = JSON.parse((result.content as any)[0].text);
console.log(page);

curl

服务器通过 HTTP 提供标准的 JSON-RPC,因此可以直接在终端里测试:

Shell
# 列出所有工具(无需密钥)
curl -s -X POST https://swarms.world/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 调用一个工具
curl -s -X POST https://swarms.world/mcp \
  -H "Authorization: Bearer $SWARMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_get-prompts","arguments":{"limit":2,"is_free":true}}}'

该选哪种方式?

你使用的工具推荐方式你将获得
Claude Code插件一次安装即可获得技能、MCP 服务器和安全的密钥存储
Codex插件一次安装即可获得技能和 MCP 服务器
任意支持技能的智能体npx skills add技能,MCP 服务器需另行配置
VS Code安装按钮或 .vscode/mcp.json在 Copilot 智能体模式中使用 MCP 工具
Cursor.cursor/mcp.jsonMCP 工具
Claude Desktopmcp-remote 桥接MCP 工具
你自己的智能体Python 或 TypeScript SDK完整的编程访问

常见问题排查

  • 工具调用返回 401。 密钥缺失或无效。请确认启动智能体的终端中已导出 SWARMS_API_KEY,并且请求头为 Authorization: Bearer <key>。
  • 看不到任何工具。 确认 URL 为 https://swarms.world/mcp,并且你的客户端支持 Streamable HTTP。只支持 stdio 的客户端请使用 mcp-remote 桥接。
  • 智能体没有使用 Swarms Marketplace。 在提问时直接点名,例如“在 Swarms Marketplace 上搜索……”。当请求与技能匹配时,技能才会被加载。
  • 技能在代码仓库中显示为新文件。 npx skills add 会安装到当前项目。请把 .agents/skills/、.claude/skills/ 和 skills-lock.json 加入 .gitignore,或者使用 -g 全局安装。

下一步

我们正在为 MCP 服务器开发 OAuth 登录,让客户端可以显示“使用 Swarms 登录”按钮,无需再粘贴密钥;同时也在推进将服务器收录到官方 MCP Registry 以及更多智能体目录中。欢迎为代码仓库点星关注进展;如果你希望我们编写新的技能,也欢迎提交 issue。

相关链接

更多文章

Swarms v17「InterLink」:通信频道、分阶段扇出工作流、RouteHub,以及四分之一秒完成导入的框架
工程

Swarms v17「InterLink」:通信频道、分阶段扇出工作流、RouteHub,以及四分之一秒完成导入的框架

Swarms v17(代号 InterLink)的完整技术更新日志。智能体和每一个主要结构现在都可以通过通信频道读取和发布消息(一个 Markdown 文件、一个队列、SQLite、一台远程 HTTP 服务器、你自己的电子邮箱,或者 AgentMail);PhasedFanOutWorkflow 让一个主导智能体把一次运行规划到数百个全新的智能体上;swarms[fast] 换上了 RouteHub;import swarms 从 1.9 秒降到 0.3 秒以内;宽图和扇出以满宽度运行;七个结构和辅助函数不再在本该交回答案的地方交回对话记录;失败的 swarm 终于会抛出异常,让 fallback_swarms 能发挥作用。2026 年 10 月 2 日到 11 月 2 日之间的每一项新特性、每一处改进、每一个缺陷修复,逐日记录。

Swarms 祝你万圣节快乐:API 五折、Pro 首月免费、Premium 首月半价
公司

Swarms 祝你万圣节快乐:API 五折、Pro 首月免费、Premium 首月半价

为庆祝万圣节,Swarms API 上的所有模型在 24 小时内五折优惠。此外,使用优惠码 SPOOKYPRO 可免费获得 Pro 首月,使用 SPOOKYPREMIUM 可享 Premium 首月五折,两个优惠码均有效至 2026 年 11 月 7 日。

Swarms Marketplace 打赏功能正式上线
产品

Swarms Marketplace 打赏功能正式上线

Swarms Marketplace 上的每一个免费智能体、提示词、工具和捆绑包,现在都可以接受打赏。用户无需离开商品页,即可通过银行卡、USDC 或 SOL 感谢创作者;创作者通过 Stripe 收款,或直接收到自己的 Solana 钱包。