Sidearm

@sidearmdrm/mcp

Sidearm API 用の MCP サーバーです。メディアを AI の学習から保護し、AI 生成コンテンツを検出して、盗用された作品を検索できます。

このパッケージは Sidearm REST API を Model Context Protocol（MCP）ツールとして公開します。AI エージェント（Cursor、Claude Desktop、Windsurf など）から直接呼び出せます。

クイックスタート

1. API キーを取得する

sdrm.io で登録し、sdrm.io/api-keys で API キーを作成します。

2. エージェントを設定する

MCP 設定ファイルに追加します。

Cursor（.cursor/mcp.json）:

{
  "mcpServers": {
    "sdrm": {
      "command": "npx",
      "args": ["-y", "@sidearmdrm/mcp"],
      "env": {
        "SDRM_API_KEY": "sk_live_..."
      }
    }
  }
}

Claude Desktop（claude_desktop_config.json）:

{
  "mcpServers": {
    "sdrm": {
      "command": "npx",
      "args": ["-y", "@sidearmdrm/mcp"],
      "env": {
        "SDRM_API_KEY": "sk_live_..."
      }
    }
  }
}

Windsurf（~/.codeium/windsurf/mcp_config.json）:

{
  "mcpServers": {
    "sdrm": {
      "command": "npx",
      "args": ["-y", "@sidearmdrm/mcp"],
      "env": {
        "SDRM_API_KEY": "sk_live_..."
      }
    }
  }
}

これで完了です。エージェントから Sidearm ツールを呼び出せるようになります。

ツール（27）

検出

ツール	説明
list_algorithms	利用可能な保護アルゴリズムを参照します。カテゴリーまたはメディアタイプで絞り込めます。

保護と抽出

ツール	説明
run_algorithm	ID で指定したメディアに特定のアルゴリズムを実行します。非同期処理用のジョブを返します。
protect_media	プリセットのレベル（standard/maximum）でメディアを保護します。アルゴリズムは自動選択されます。
extract_embeddings	後続の類似性検索や ML パイプラインで使用する、生の埋め込みベクトルをメディアから抽出します。

ジョブ

ツール	説明
check_job	非同期ジョブのステータスを確認します。完了時に進行状況と結果を返します。

検出

ツール	説明
detect_ai	メディアが AI 生成かどうかを検出します。画像、動画、音声、テキストに対応しています。
detect_fingerprint	フィンガープリント照合を使用して、メディアが以前に登録されているか確認します。
detect_membership	自分のコンテンツが疑わしい AI モデルの学習に使われたかどうかを確認します。

検索

ツール	説明
search_media	インデックス化されたライブラリ全体から、類似するメディアを検索します。
list_searches	アカウントで過去に実行した検索を一覧表示します。

メディア管理

ツール	説明
register_media	オプションの保護モード（register、search_ready、standard、maximum）を指定して、メディアを登録し、インデックス化します。
list_media	ライブラリ内のメディアアセットを一覧表示します（ページネーション対応、絞り込み可能）。
get_media	保護ステータスや適用済みアルゴリズムを含む、特定のメディアアセットの詳細を取得します。
update_media	メディアのメタデータ（元の URL など）を更新します。
delete_media	メディアアセットと関連データをすべて完全に削除します。

アカウント、権利、請求

ツール	説明
get_account	アカウントの詳細（ID、名前、メールアドレス、クレジット残高、プラン情報）を取得します。
get_rights	メディアアセットの C2PA、IPTC、権利情報を取得します。
get_billing	クレジット残高、使用状況の内訳、アルゴリズムごとの料金、請求ポータルへのリンクを確認します。

来歴と識別

ツール	説明
get_provenance	アセットの完全な来歴チェーン（アルゴリズム、C2PA マニフェスト、メンバーシップの結果）を取得します。
identify_media	埋め込み済みの Sidearm フィンガープリントでメディアを識別し、C2PA の来歴チェーンを抽出します。

共有

ツール	説明
create_share	検出、検索、または来歴の結果を共有するリンクを作成します（最初は非公開です）。
get_share	共有 ID を指定して、共有された結果を取得します。
publish_share	共有された結果を一般公開します。

削除記録

ツール	説明
list_deletions	完全に削除されたアセットを記録した削除記録を一覧表示します。
get_deletion	消去されたアルゴリズムやストレージのステータスを含む、特定の削除記録の詳細を取得します。

ドキュメント

ツール	説明
search_docs	Sidearm API ドキュメントを検索します。開発者向けリファレンス全体から関連するセクションを返します。
navigate_ui	Sidearm ダッシュボードでの操作方法を調べます。手順を追った説明を返します。

エージェントとの会話例

「この画像を AI の学習から保護してください」

エージェントは画像の URL を指定して protect_media を呼び出し、続けて check_job を呼び出して保護されたファイルを取得します。

「音声で利用できるアルゴリズムは何ですか？」

エージェントは media_type: "audio" を指定して list_algorithms を呼び出します。

「私のアートワークに Nightshade と Glaze を実行してください」

エージェントは algorithms: ["nightshade", "glaze"] を指定して run_algorithm を呼び出します。

「この写真は AI で生成されたものですか？」

エージェントは画像を指定して detect_ai を呼び出し、続けて check_job を呼び出して結果を取得します。

「私のアートワークは Stable Diffusion の学習に使われましたか？」

エージェントはメディア ID とモデル名を指定して detect_membership を呼び出します。

「ダッシュボードでファイルをアップロードする方法を教えてください」

エージェントは query: "upload files" を指定して navigate_ui を呼び出し、手順を追った説明を取得します。

環境変数

変数	必須	説明
SDRM_API_KEY	はい	Sidearm API キー（sk_live_... または sk_test_...）
SDRM_BASE_URL	いいえ	API のベース URL を上書きします（デフォルト：https://api.sdrm.io）

開発

git clone https://github.com/sidearmDRM/mcp-server.git
cd mcp-server
npm install
npm run build

MCP Inspector を使ってローカルでテストします。

SDRM_API_KEY=sk_test_... npx @modelcontextprotocol/inspector node dist/index.js

ライセンス

MIT