AVCLabs Media MCP

media-mcp monorepo

English | 中文

封装 AVCLabs 托管媒体服务的 MCP 服务，按每个 npm 包一个功能发布，使 MCP 客户端会话只加载实际使用的工具定义。

Packages

Package	Function	Tools	Bin
@avclabs.ai/video-mcp	视频增强	create_task, get_task_status, enhance_video_sync	video-mcp
@avclabs.ai/image-mcp	图像增强 / 上色 / 降噪	enhance_image_sync, colorize_image_sync, denoise_image_sync, get_image_task_status	image-mcp
@avclabs.ai/sam3-mcp	SAM3 图像分割	sam3_predict, get_sam3_task_status	sam3-mcp
@avclabs.ai/media-mcp	旧版全功能包（全部 9 个工具）	以上所有工具	media-mcp
@avclabs.ai/media-mcp-core	共享内部库（不是 MCP 服务）	—	—

Why one function per package

• 更小的上下文：MCP 客户端会将每个已配置服务的所有工具定义（名称、描述、JSON schema）注入会话。只需要图像工具的客户端不再需要为视频和 SAM3 定义付出代价。
• 减少工具歧义：只存在一个 get_*_task_status 变体时，模型能更可靠地选择工具。
• 独立启用：为每个客户端或受众（例如，仅向标注团队提供 SAM3）准确开放一个功能。

旧版全功能包 @avclabs.ai/media-mcp 对现有配置仍可照常使用；迁移说明请参阅其 README。

Quick start

每个服务都是通过 npx 运行的 stdio MCP 服务。例如，仅使用图像工具：

{
  "mcpServers": {
    "image-mcp": {
      "command": "npx",
      "args": ["-y", "-p", "@avclabs.ai/image-mcp@latest", "image-mcp"],
      "env": { "API_KEY": "your-api-key" }
    }
  }
}

每个包都只提供一个与包同名的 bin，因此直接运行 npx -y <package> 也可以；示例使用显式的 -p <package> <bin> 形式，因为无论包的 bin 集合如何变化，这种写法都能固定使用确切的二进制文件。 每个包的 README（video、image、SAM3）都包含 Claude Code、Cursor 和全局安装的完整说明，以及所读取的配置变量。

所有包共用一个 API_KEY，并使用相同的生产环境主机默认值（https://mcp.avc.ai/enhance 和 https://mcp.avc.ai/sam）。

Repository layout

packages/
  core/       shared library: tool registration, polling, TOS upload, config
  video-mcp/  video enhancement server (3 tools)
  image-mcp/  image processing server (4 tools)
  sam3-mcp/   SAM3 segmentation server (2 tools)
  media-mcp/  legacy all-in-one server (9 tools)

各包共用的领域术语见 CONTEXT.md；相关决策记录于 docs/adr/。

Development and release

npm ci               # installs workspaces and builds every package
npm test             # rebuild + run all package tests
npm run release:verify   # metadata gate + audit + tests + pack dry-run
node scripts/e2e-check.mjs  # stdio E2E for all four server entries

若要迭代开发某个包：先构建一次 core（npm run build -w packages/core），然后在另一个终端运行 npm run dev -w packages/<pkg>（tsc --watch）。

维护者：发布顺序（先发布 core）、版本管理、标签和冒烟测试请参阅发布指南。发布需从干净的检出手动进行；CI 工作流会在 Node 22 上运行相同的验证门禁。

License

MIT 许可证 — 参阅 LICENSE。