AVCLabs Media MCP

media-mcp モノレポ

English | 中文

AVCLabs のホスト型メディアサービスをラップする MCP サーバーです。1 つの関数を 1 つの npm パッケージとして公開しているため、MCP クライアントのセッションには、実際に使用するツール定義だけが読み込まれます。

パッケージ

パッケージ	機能	ツール	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 サーバーではありません）	—	—

1 つのパッケージにつき 1 つの関数にする理由

• コンテキストの縮小：MCP クライアントは、設定された各サーバーのすべてのツール定義（名前、説明、JSON スキーマ）をセッションに読み込みます。画像ツールだけが必要なクライアントは、動画や SAM3 の定義を読み込まずに済みます。
• ツールの曖昧さの軽減：get_*_task_status のバリエーションが 1 つだけ存在するため、モデルがより確実にツールを選択できます。
• 個別の有効化：クライアントごと、または対象ユーザーごとに、必要な関数だけを公開できます（例：アノテーションチームには SAM3 のみ）。

従来のオールインワン @avclabs.ai/media-mcp は、既存の設定でも変更なく引き続き動作します。移行に関する注意事項は、こちらの README をご覧ください。

クイックスタート

すべてのサーバーは、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 が 1 つだけ含まれているため、npx -y <package> だけでも動作します。ここでは、パッケージの bin セットが変更されてもバイナリを正確に指定できるよう、明示的な -p <package> <bin> 形式を使用しています。 各パッケージの README（video、image、SAM3）には、Claude Code、Cursor、グローバルインストール向けの詳しいインストール手順と、読み込まれる設定変数が記載されています。

すべてのパッケージで共通の API_KEY と、本番環境のホストのデフォルト値（https://mcp.avc.ai/enhance および https://mcp.avc.ai/sam）を使用します。

リポジトリの構成

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/ に記録されています。

開発とリリース

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

1 つのパッケージを開発するには、まず core を 1 回ビルドし（npm run build -w packages/core）、別のターミナルで npm run dev -w packages/<pkg>（tsc --watch）を実行します。

メンテナーの方は、公開順序（core が先）、バージョン管理、タグ、スモークテストについて、リリースガイドをご覧ください。公開はクリーンなチェックアウトから手動で行います。CI ワークフローでは、Node 22 上で同じ検証ゲートを実行します。

ライセンス

MIT License — 詳細は LICENSE をご覧ください。