@t-campbell18/描述mcp
MCP（模型上下文协议）服务器 API说明。使AI助手能够导入媒体、运行AI编辑、管理作业等，所有这些都可以通过自然语言完成。
先决条件
- Node.js>=18
- A. 描述API令牌 （范围为驱动器）
安装
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 | 描述API承载令牌 | $DESCRIPT_API_TOKEN |
--log-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许可证
麻省理工学院