内容
<p align="center">
<a href="https://three.ws"><img src="https://three.ws/three-ws-mcp-icon.svg" alt="three.ws" width="88" height="88"></a>
</p>
<h1 align="center">@three-ws/marketplace-mcp</h1>
<p align="center"><strong>从任何 AI 代理浏览 three.ws 代理市场和技能目录。</strong></p>
<p align="center">
<a href="https://www.npmjs.com/package/@three-ws/marketplace-mcp"><img alt="npm" src="https://img.shields.io/npm/v/@three-ws/marketplace-mcp?logo=npm&color=cb3837"></a>
<img alt="license" src="https://img.shields.io/npm/l/@three-ws/marketplace-mcp?color=3b82f6">
<img alt="node" src="https://img.shields.io/node/v/@three-ws/marketplace-mcp?color=339933&logo=node.js">
<a href="https://registry.modelcontextprotocol.io/?q=io.github.nirholas"><img alt="MCP Registry" src="https://img.shields.io/badge/MCP%20Registry-io.github.nirholas-0ea5e9"></a>
<a href="https://three.ws"><img alt="three.ws" src="https://img.shields.io/badge/built%20by-three.ws-000"></a>
</p>
---
> 一个 [Model Context Protocol](https://modelcontextprotocol.io) 服务器，允许任何 AI 助手通过 stdio 浏览和发现 three.ws 市场。搜索和分页发布的代理，深入了解某个代理的详细信息，并探索可重用的技能目录 — 所有这些都来自 three.ws 的公共 API。
无需 API 密钥，无需签名，无需支付 — 每次调用都直接命中公共的 `/api/marketplace` 和 `/api/skills` 端点。创建或发布代理和技能是 HTTP API 的*身份验证写入路径*；此服务器仅暴露浏览/发现功能。
## 安装
```bash
npm install @three-ws/marketplace-mcp
```
或使用 `npx` 运行（无需安装）：
```bash
npx @three-ws/marketplace-mcp
```
## 快速开始
**Claude 代码**，一行命令：
```bash
claude mcp add marketplace -- npx -y @three-ws/marketplace-mcp
```
**Claude 桌面版 / Cursor**（`claude_desktop_config.json` 或 `mcp.json`）：
```json
{
"mcpServers": {
"marketplace": {
"command": "npx",
"args": ["-y", "@three-ws/marketplace-mcp"]
}
}
}
```
使用 MCP Inspector 检查表面：
```bash
npx -y @modelcontextprotocol/inspector npx @three-ws/marketplace-mcp
```
## 工具
| 工具 | 类型 | 功能 |
| ------------------- | --------- | ---------------------------------------------------------------------------------------------------- |
| `browse_agents` | 只读 | 搜索和分页代理市场 — 按类别和查询过滤、排序、分页。 |
| `agent_detail` | 只读 | 按 ID 获取已发布的代理（系统提示、功能、作者、评分、技能价格、头像）。 |
| `agent_categories` | 只读 | 列出代理类别及其已发布代理数量，以及总数量。 |
| `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`（必需：代理的 UUID，来自 `browse_agents` 卡片）。
**`agent_categories`** — 无参数。
**`browse_skills`** — `q`（可选的自由文本）、`category`（可选的 slug）、`sort`（`popular` | `new` | `az`，默认为 `popular`）、`limit`（1–50，默认为 20）、`cursor`（可选的分页游标）。
**`skill_categories`** — 无参数。
## 示例
```jsonc
// browse_agents
> { "q": "代码审查", "sort": "top_rated", "limit": 3 }
{
"ok": true,
"items": [
{
"id": "a1b2c3d4-…",
"name": "代码审查器",
"description": "检查代码差异中的错误和风格。",
"category": "编程",
"tags": ["代码", "审查"],
"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` 传回以获取下一页。
## 要求
- **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](./LICENSE)
---
<p align="center">
<sub>
three.ws SDK 套件的一部分 — 3D AI 代理、链上身份和代理支付。<br/>
<a href="https://three.ws">网站</a> · <a href="https://three.ws/changelog">更新日志</a> · <a href="https://github.com/nirholas/three.ws">GitHub</a>
</sub>
</p>
## 许可证
Copyright © 2026 nirholas. All rights reserved.
本软件为专有软件 — 见 [LICENSE](./LICENSE)。未经版权所有者明确书面许可，不得授予任何权利。
