# @evolinkai/mcp 中文文档

规范地址：https://npmcn.com/package/%40evolinkai/mcp/

版本：1\.12\.1
npm 元数据更新时间：2026-11-09T14:55:25.214Z
中文译文更新时间：2026-11-14T13:15:54.185Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40evolinkai/mcp
原文对照：https://npmcn.com/package/%40evolinkai/mcp/?lang=original
项目主页：https://evolink.ai/mcp
源码仓库：https://github.com/Evolink-AI/evolink-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.7 MB，231 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-10-07T07:50:16.682Z
- 最新版本发布：2026-11-09T14:55:25.064Z
- 近 30 天下载量：2037（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

以一个API键生成AI视频,图像和音乐. 150+模型(种子,克林克,维奥,索拉,GPT影像,苏诺. ).

## 安装

```sh
npm install @evolinkai/mcp
```

也可以使用：`pnpm add @evolinkai/mcp`、`yarn add @evolinkai/mcp`、`bun add @evolinkai/mcp`

## README

# @ evolinkai/ mcp

> 以一个API键生成AI视频,图像和音乐. 150+型号包括种子,克林克,Veo,Sora,GPT影像,Suno等.

未放行的搜索-收费修补:对于7条被审查的媒体路线,搜索默认 关闭。 除非用户明确要求或批准,否则不得使用. 如果 代理商认为需要搜索,解释额外的每搜索率和未知数 总计,然后等待同意后才能批准。 不搜索任务批准 不授权添加搜索。 启用时, 估计返回 `search_charges` 以当前每个搜索率计算。 未知的计数会产生部分零搜索子总和, 不包括搜索 费用;单项任务不得进行搜索或多次搜索。 预期数 是假设,而不是执行限制。 在批准前解释这些指控.

**EvoLink 媒体** 是一个MCP(Model Context Protocol)服务器,它赋予克洛德等AI助手通过统一的API生成多媒体内容的能力.

## 快速启动

```bash
npx @evolinkai/mcp
```

设置您的 API 密钥 :

```bash
export EVOLINK_API_KEY="your-key-here"
```

获取您的 API 密钥 [evolink.ai/dashboard/键盘](https://evolink.ai/dashboard/keys?utm_source=npm&utm_medium=referral&utm_campaign=mcp_local&utm_content=readme_keys)。 。 。 .

## MCP 配置

### 克劳德桌面

```json
{
  "mcpServers": {
    "evolink-mcp": {
      "command": "npx",
      "args": ["-y", "@evolinkai/mcp@latest"],
      "env": {
        "EVOLINK_API_KEY": "your-key-here",
        "EVOLINK_UPLOAD_ALLOWED_DIRS": "/absolute/path/to/media"
      }
    }
  }
}
```

### 光标

转到 **设置 — MCP** 并添加:

-   命令 : `npx -y @evolinkai/mcp@latest`
-   环境: `EVOLINK_API_KEY=your-key-here`

## 可用工具

| 工具 | 说明 | 费用 |
| --- | --- | --- |
| `search_models` | 按类型和关键词查找图像、视频和音频模型 | 免费 |
| `recommend_models` | 比较已记录的替代品和参考投入 | 免费 |
| `search_docs` | 查找版本的模型参考摘录和正式链接 | 免费 |
| `get_model` | 模型的参数、价格和实例输入 | 免费 |
| `estimate_cost` | 检查投入并估算成本,不提交 | 免费 |
| `generate_image` | 生成或编辑图像( 最多等待 40 s 才能得出结果) | 已支付 |
| `generate_video` | 生成视频( 返回任务 id) | 已支付 |
| `generate_audio` | 生成音乐、歌曲或语音( 返回任务 id) | 已支付 |
| `get_task` | 检查任务, 最多45 s; 结果链接和最终收费 | 免费 |
| `list_tasks` | 读取最多50个任务, 或找到最近的任务 | 免费 |
| `get_task_usage` | 用覆盖元数据汇总保留的任务完成费用 | 免费 |
| `upload_file` | 将媒体文件变成生成输入的链接 | 免费 |
| `check_balance` | 账户余额,这把钥匙的支出, 上调链接 | 免费 |

没有服务器侧批准步骤:生成工具具有标记破坏性,助手必须引用到 `estimate_cost` 第一;客户端设置控制提示. `max_cost_usd` 维护提交估计,而不是最后结算。 每一份呈文都带有“一能”密钥;用原声重复不确定的呼唤 `client_request_id` 防止双重收费。 在提交之前检查输入,错误包括下一步。 本地上传路径必须在内部 `EVOLINK_UPLOAD_ALLOWED_DIRS`。执行 API 键助手 `credential get` 可能配置为 `EVOLINK_CREDENTIAL_HELPER`。浏览器登录 `@evolinkai/cli` 是独立的 OAuth 客户端,不导出 API 密钥或执行此帮助合同.

`get_model` 包括版本输入/提交计划和其他运行时间限制. `search_docs` 搜索捆绑的模型参考文献;建议解释编辑理由和文件投入,而不是模型质量或任务总数. `list_tasks` 返回页面;自此/至过滤所选页面. `get_task_usage` 最多扫描20页的全账户保留任务,有效完成的任务报告费用总额,并报告缺少费用和覆盖面。 它不包括付款/退款分类账,不是发票或最后预算。 没有取消工具 .

## 模型

150+图像,视频和音频模型(种子,克林,Veo,Sora,Suno,GPT图像,纳米香蕉等). 使用 `search_models` 用价格浏览它们.

一个成功的 `get_task` 可能报告 `status: failed` a. 无需作为工具出错; `error.code` 财务报告和审定财务报表 `error.message` 是API报告的内容(一条线上的信息,没有秘密,服务地址或非EvoLink链接). 未收取失败的任务: 自动返回提交时保留的入计量( Q)`billing_note`) (中文(简体) ). 失败/ 取消的任务曝光 `billing.refund_status`;没有这些证据的旧通道依然存在 `unknown`,以及 `refunded` 被省略,所以一个没有证据的被取消的任务仍未核实。 已完成的退款仅指账面余额,并有入账的入帐凭证和时间戳;本记录未确定密钥限额恢复. 另一代人需要新的估计和明确的用户批准.

使用已支付请求失败 `submission_state` (单位:千美元)`not_submitted`, (中文(简体) ), `rejected`, (中文(简体) ), `outcome_unknown`,或 `accepted`)独立于出错类别。 只有当地预先拒绝或承认的网关拒绝录取报告 `charged: no`通用5xx、运输/身体故障或未经核实的成功反应报告 `charged: unknown`; 在创建另一个支付意向之前, 回收原始任务或相同的请求ID。 对于这些请求错误,远程道具和建议被取而代之的是公共指导;控制台动作使用官方来源并允许路径.

## 许可证

阿帕奇 -2.0 - (英语) [EvoLink 大赦国际](https://evolink.ai/?utm_source=npm&utm_medium=referral&utm_campaign=mcp_local&utm_content=readme_home)

## 常见问题

### @evolinkai/mcp 是什么？

以一个API键生成AI视频,图像和音乐\. 150\+模型\(种子,克林克,维奥,索拉,GPT影像,苏诺\. \)\.

### 如何安装 @evolinkai/mcp？

在项目目录运行 npm install @evolinkai/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 evolink-mcp，可以用 npx evolink-mcp 直接运行。

### @evolinkai/mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @evolinkai/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @evolinkai/mcp 可以商用吗？

@evolinkai/mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @evolinkai/mcp 的下载量有多少？

根据 npm 官方下载统计，@evolinkai/mcp 在 2026/10/14 – 2026/11/12 这 30 天内被下载 2,037 次，日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @evolinkai/mcp 还在维护吗？

最新版本 1\.12\.1 发布于 2026/11/09（4 天前）；至今共发布 17 个版本，其中过去 12 个月发布了 17 个；首次发布于 2026/10/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。