three.ws Marketplace

@three-ws/marketplace-mcp

从任何 AI Agent 浏览 three.ws Agent 市场和技能目录。

---

一个 Model Context Protocol 服务，可通过 stdio 为任何 AI 助手提供对 three.ws 市场的浏览和发现功能。搜索并分页浏览已发布的 Agent，按 ID 深入查看 Agent，并探索可复用的技能目录——所有操作均通过 three.ws 公共 API 完成。

无需 API 密钥、签名者或付款——每次调用都会访问公共 /api/marketplace 和 /api/skills 端点。创建或发布 Agent 和技能属于 HTTP API 上的需认证写入操作；此服务仅提供浏览和发现功能。

安装

npm install @three-ws/marketplace-mcp

或者使用 npx 运行（无需安装）：

npx @three-ws/marketplace-mcp

快速开始

Claude Code，一行命令：

claude mcp add marketplace -- npx -y @three-ws/marketplace-mcp

Claude Desktop / Cursor（claude_desktop_config.json 或 mcp.json）：

{
	"mcpServers": {
		"marketplace": {
			"command": "npx",
			"args": ["-y", "@three-ws/marketplace-mcp"]
		}
	}
}

使用 MCP Inspector 查看可用功能：

npx -y @modelcontextprotocol/inspector npx @three-ws/marketplace-mcp

工具

工具	类型	功能
browse_agents	只读	搜索并分页浏览 Agent 市场——按类别和查询词筛选、排序，并使用游标分页。
agent_detail	只读	按 ID 获取一个已发布的 Agent（系统提示词、能力、作者、评分、技能价格、头像）。
agent_categories	只读	列出 Agent 类别及每个类别中已发布的 Agent 数量，以及总数。
browse_skills	只读	搜索并分页浏览技能目录——按查询词和类别筛选、排序，并使用游标分页。
skill_categories	只读	列出至少包含一个公开技能的类别，每项包含 slug、标签和数量。

输入参数

browse_agents — category（可选 slug）、q（可选自由文本）、sort（recommended | recent | popular | top_rated，默认 recommended）、limit（1–48，默认 24）、cursor（可选分页游标）。

agent_detail — id（必填：Agent 的 UUID，可从 browse_agents 卡片中获取）。

agent_categories — 无参数。

browse_skills — q（可选自由文本）、category（可选 slug）、sort（popular | new | az，默认 popular）、limit（1–50，默认 20）、cursor（可选分页游标）。

skill_categories — 无参数。

示例

// browse_agents
> { "q": "code review", "sort": "top_rated", "limit": 3 }
{
  "ok": true,
  "items": [
    {
      "id": "a1b2c3d4-…",
      "name": "Code Reviewer",
      "description": "Reviews diffs for bugs and style.",
      "category": "programming",
      "tags": ["code", "review"],
      "rating_avg": 4.8,
      "rating_count": 22,
      "views_count": 1340,
      "forks_count": 41,
      "thumbnail_url": "https://…",
      "avatar_glb_url": "https://…"
    }
  ],
  "next_cursor": "3"
}

将 next_cursor 作为 cursor 传回，即可获取下一页。

示例

可运行的示例位于 examples/：

node examples/list-tools.mjs            # every tool with its full input schema
node examples/browse-marketplace.mjs    # categories + agents + detail + skills, live

这两个示例都会通过 stdio 启动此服务，并读取实时公共目录。这里的所有工具均为只读，因此无法发布或购买任何内容。预期输出请参阅 examples/README.md。

要求

• Node.js >= 20。
• 可访问网络 https://three.ws（或你自己的 THREE_WS_BASE）。

环境变量

变量	必填	默认值
THREE_WS_BASE	否	https://three.ws
THREE_WS_TIMEOUT_MS	否	20000

链接

• 主页：https://three.ws
• 更新日志：https://three.ws/changelog
• 问题反馈：https://github.com/nirholas/three.ws/issues
• 许可证：Apache-2.0，参见 LICENSE

---

_{属于 three.ws SDK 套件的一部分 — 3D AI Agent、链上身份和 Agent 支付。
网站 · 更新日志 · GitHub}