AI导哈

Descript模型上下文协议服务器

Descript模型上下文协议服务器，通过自然语言实现媒体导入、AI编辑和任务管理。

  • by T-Campbell18
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 T-Campbell18/descript-mcp

使用说明

@t-campbell18/描述mcp

MCP（模型上下文协议）服务器 API说明。使AI助手能够导入媒体、运行AI编辑、管理作业等，所有这些都可以通过自然语言完成。

先决条件

安装

npm install -g @t-campbell18/descript-mcp

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

npx @t-campbell18/descript-mcp --token YOUR_TOKEN

配置

克劳德代码

claude mcp add descript -- npx @t-campbell18/descript-mcp --token YOUR_TOKEN

或添加到您的 .claude/settings.json:

{
  "mcpServers": {
    "descript": {
      "command": "npx",
      "args": ["@t-campbell18/descript-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}

克劳德桌面

添加到您的 claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "descript": {
      "command": "npx",
      "args": ["@t-campbell18/descript-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}

光标

添加到您的 .cursor/mcp.json:

{
  "mcpServers": {
    "descript": {
      "command": "npx",
      "args": ["@t-campbell18/descript-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}

帆板运动

添加到您的 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "descript": {
      "command": "npx",
      "args": ["@t-campbell18/descript-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}

环境变量（所有平台）

而不是通过 --token，您可以设置 DESCRIPT_API_TOKEN 环境变量：

{
  "mcpServers": {
    "descript": {
      "command": "npx",
      "args": ["@t-campbell18/descript-mcp"],
      "env": {
        "DESCRIPT_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

工具

工具 说明
import_media 将媒体文件导入项目并创建合成。自动轮询，直到完成。
run_agent 通过自然语言执行AI编辑（例如“删除填充词”）。自动轮询，直到完成。
list_jobs 使用可选筛选器和分页列出最近的作业。
get_job 获取特定作业的状态和结果。
cancel_job 取消正在运行的作业。
check_status 检查API运行状况并验证您的令牌。（WIP）
create_import_url 生成一次性“在描述中编辑”导入URL
get_published_project 获取已发布项目的元数据和字幕。

CLI选项

标志 描述 默认值
--token <token> 描述API承载令牌 $DESCRIPT_API_TOKEN
--log-level <level> 日志冗长： debug, info, warn, error info

特性

  • 自动轮询: import_media 和 run_agent 轮询，直到作业以指数级回退完成（1秒、2秒、4秒、8秒、10秒上限）。每次通话的可配置超时时间 timeout_ms 参数（默认值：5分钟）。
  • 费率限制处理：使用以下命令自动重试HTTP 429响应 Retry-After 头球
  • 输入验证：在调用API之前，使用Zod模式验证所有工具输入。
  • 结构化错误：返回API错误时包含HTTP状态代码和详细信息，而不是原始堆栈跟踪。

发展

git clone https://github.com/YOUR_USERNAME/descript-mcp.git
cd descript-mcp
npm install
npm run build
npm test

许可证

麻省理工学院

相关 MCP