mcpField
I
importly-mcp

importly-mcp

本地服务
github.com/yyildiz媒体与设计015 周前更新
代码仓库

关于 importly-mcp

importly-mcp 让 AI Agent 下载、转录并检查受支持网站上的视频或音频 URL。工具以异步任务运行，可返回托管媒体链接、转录文本或元数据。

主要功能

  1. 01从 URL 下载媒体
  2. 02转录语音并提供时间戳
  3. 03获取详细媒体元数据
  4. 04快速查询基础元数据
  5. 05查询剩余额度

适用场景

  1. 01转录演讲并查看内容
  2. 02下载播客单集音频
  3. 03查询视频时长和上传者

MCP 相关

该 MCP 服务封装 Importly API，向 MCP 客户端提供媒体导入、转录、元数据和额度查询工具。耗时任务会返回任务 ID，客户端可轮询查询。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "io-importly-importly": {
      "command": "npx",
      "args": [
        "-y",
        "importly-mcp"
      ],
      "env": {
        "IMPORTLY_API_KEY": "<IMPORTLY_API_KEY>"
      }
    }
  }
}
启动命令npx -y importly-mcp
需要配置的环境变量
IMPORTLY_API_KEY密钥Importly API key — free key with $3 credits at https://importly.io/?utm_source=mcp&utm_medium=integration&utm_campaign=official-registry

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmimportly-mcp0.1.0

工具

9

收录的工具列表 · 更新于 2 周前

参数类型必填说明
urlstring是媒体页面 URL，例如 https://www.youtube.com/watch?v=...
audioQualityenum否默认 mediumlowest | low | medium | high | best
includeAudioboolean否包含音频流（默认 true）
includeVideoboolean否包含视频流（默认 true）
videoQualityenum否默认 720plowest | 144p | 240p | 360p | 480p | 720p | 1080p | 1440p | 2160p | best
includeTranscriptboolean否在同一任务中同时转写音频
transcriptLanguagestring否用于文字稿的 ISO 语言提示，例如 "en"

详细介绍

Importly MCP 服务

让你的 AI Agent 能够下载、转录并检查任何视频或音频 URL——YouTube、TikTok、X、播客以及其他 1000 多个网站。

Importly 在服务端运行 yt-dlp、轮换住宅代理、ffmpeg 和语音转文本服务，因此你的 Agent（以及你）无需处理 IP 封禁、429 错误、Cookie 失效或提取器故障。

工具

工具功能
import_media / check_import将媒体下载到托管存储，获取直链（可选择附带转录文本）
transcribe_media / check_transcription语音转文本，并提供带时间戳的片段
get_metadata / check_metadata完整元数据：格式、上传者、缩略图、统计数据
get_basic_metadata / check_basic_metadata快速查询标题、时长和缩略图
check_balance查询剩余积分余额

任务以异步方式运行：提交工具会返回一个 jobId，查询工具会轮询该任务。响应会准确告知 Agent 下一步该做什么。

设置

  1. 在 importly.io 获取 API 密钥——赠送 $3.00 免费额度，无需银行卡。
  2. 将服务添加到你的 MCP 客户端：
Claude Code
claude mcp add importly -e IMPORTLY_API_KEY=your_key -- npx -y importly-mcp
Claude Desktop / Cursor / Cline / Windsurf
{
  "mcpServers": {
    "importly": {
      "command": "npx",
      "args": ["-y", "importly-mcp"],
      "env": { "IMPORTLY_API_KEY": "your_key" }
    }
  }
}

（Claude Desktop：claude_desktop_config.json · Cursor：.cursor/mcp.json · Cline：MCP 设置界面 · Windsurf：~/.codeium/windsurf/mcp_config.json）

示例提示词

定价

按用量计费，使用积分（下载约 $0.01/MB，转录按媒体分钟计费）——详见定价。新账户可获得 $3.00 免费额度。

文档与支持

采用 MIT 许可证。该服务只是 Importly API 的轻量封装。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。