内容
# envato-mcp
一款适用于 [Envato API](https://build.envato.com/) 的[模型上下文协议](https://modelcontextprotocol.io)（MCP）服务器。它允许与MCP兼容的AI客户端（Claude Desktop、Cursor等）搜索Envato Market目录，查找作者统计信息，检查买家的购买记录，并读取经过身份验证的用户帐户详细信息。
## 功能
- **目录搜索** — 全文搜索商品，热门商品和Envato Market网站（ThemeForest，CodeCanyon等）的分类列表。
- **作者统计** — 公共用户信息，每个网站的商品数量，徽章和市场范围内的总数。
- **买家/购买记录** — 列出购买记录，获取下载链接和验证购买代码。
- **账户信息** — 已认证用户的账户，用户名和电子邮件。
每个工具都使用 [zod](https://zod.dev) 验证其输入并返回原始Envato JSON响应。API错误（包括`401`/`403`身份验证失败和`429`速率限制）都以清晰，可行的消息显示。
## 要求
- Node.js 18 或更高版本。
- 一个Envato个人令牌（见下文）。
## 获取Envato令牌
1. 前往 <https://build.envato.com/create-token/>。
2. 选择所需的权限。例如：
- *查看和搜索Envato网站* — 目录工具。
- *查看您的Envato账户用户名* / *电子邮件* — 账户工具。
- *查看您商品的销售历史* / *列出您购买的商品* — 买家工具。
- *下载您购买的商品* — 下载链接。
3. 创建令牌并复制它。您将把它作为`ENVATO_TOKEN`环境变量传递给服务器。
## 用法
直接使用`npx`运行（无需安装）：
```bash
ENVATO_TOKEN=您的令牌 npx envato-mcp
```
服务器通过stdio进行通信，旨在由MCP客户端启动，而不是交互式使用。
### Claude Desktop
将服务器添加到您的`claude_desktop_config.json`：
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"envato": {
"command": "npx",
"args": ["-y", "envato-mcp"],
"env": {
"ENVATO_TOKEN": "您的令牌"
}
}
}
}
```
### Cursor
将服务器添加到 `~/.cursor/mcp.json`（或项目中的 `.cursor/mcp.json`）：
```json
{
"mcpServers": {
"envato": {
"command": "npx",
"args": ["-y", "envato-mcp"],
"env": {
"ENVATO_TOKEN": "您的令牌"
}
}
}
}
```
保存后，重启客户端使其获取新的服务器。
## 工具
### 目录搜索
| 工具 | 描述 | 参数 |
| --- | --- | --- |
| `envato_search_items` | 搜索目录中与术语匹配的商品。 | `term`（字符串，必填），`site`（字符串，可选），`page`（整数，可选），`page_size`（整数1-100，可选） |
| `envato_popular_items` | 某个网站的热门商品。 | `site`（字符串，例如 `themeforest`） |
| `envato_categories` | 某个网站的所有分类。 | `site`（字符串，例如 `codecanyon`） |
### 作者统计
| 工具 | 描述 | 参数 |
| --- | --- | --- |
| `envato_user_info` | 用户的公共账户详细信息。 | `username`（字符串） |
| `envato_user_items_by_site` | 用户在每个网站上销售的商品数量。 | `username`（字符串） |
| `envato_user_badges` | 用户获得的徽章。 | `username`（字符串） |
| `envato_market_totals` | Envato Market的总用户数和商品数。 | 无 |
### 买家/购买记录
| 工具 | 描述 | 参数 |
| --- | --- | --- |
| `envato_list_purchases` | 列出认证买家的购买记录。 | `filter_by`（枚举，可选），`page`（整数，可选） |
| `envato_download_link` | 已购买商品的下载链接。 | `item_id`（整数） |
| `envato_verify_purchase` | 验证购买代码并返回销售详情。 | `code`（字符串） |
### 账户信息
| 工具 | 描述 | 参数 |
| --- | --- | --- |
| `envato_account` | 已认证用户的账户详细信息。 | 无 |
| `envato_my_username` | 已认证用户的用户名。 | 无 |
| `envato_my_email` | 已认证用户的电子邮件。 | 无 |
## 开发
```bash
npm install # 安装依赖
npm run dev # 更改时重建（tsup --watch）
npm run typecheck # 使用tsc进行类型检查（无输出）
npm run lint # 使用ESLint进行代码检查
npm run build # 使用tsup将代码打包到dist/
```
构建输出一个可执行的ESM包到`dist/index.js`，带有Node shebang，作为`envato-mcp`二进制文件。
## License
[MIT](./LICENSE) © 2026 Scott McAuley
