io.github.ebadros/sidearm

Name: io.github.ebadros/sidearm
Author: sidearmdrm

编码与调试

by sidearmdrm

用于保护媒体作品免受 AI 训练抓取，识别 AI 生成内容，并帮助发现被盗用的原创作品。

GitHub

什么是 io.github.ebadros/sidearm？

用于保护媒体作品免受 AI 训练抓取，识别 AI 生成内容，并帮助发现被盗用的原创作品。

README

@sidearmdrm/mcp

MCP server for the Sidearm API — protect media from AI training, detect AI-generated content, and search for stolen work.

This package exposes the Sidearm REST API as Model Context Protocol (MCP) tools that AI agents (Cursor, Claude Desktop, Windsurf, etc.) can call directly.

Quick Start

1. Get an API key

2. Configure your agent

Add to your MCP configuration file:

Cursor (.cursor/mcp.json):

json

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

Claude Desktop (claude_desktop_config.json):

json

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

Windsurf (~/.codeium/windsurf/mcp_config.json):

json

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

That's it. Your agent can now call Sidearm tools.

Tools (27)

Discovery

Tool	Description
`list_algorithms`	Browse available protection algorithms. Filter by category or media type.

Protection & Extraction

Tool	Description
`run_algorithm`	Run specific algorithms on media by ID. Returns a job for async processing.
`protect_media`	Protect media with a preset level (standard/maximum). Auto-selects algorithms.
`extract_embeddings`	Extract raw embedding vectors from media for downstream similarity search or ML pipelines.

Jobs

Tool	Description
`check_job`	Poll async job status. Returns progress and results when complete.

Detection

Tool	Description
`detect_ai`	Detect whether media was AI-generated. Supports image, video, audio, text.
`detect_fingerprint`	Check if media has been previously registered using fingerprint matching.
`detect_membership`	Test whether your content was used to train a suspect AI model.

Search

Tool	Description
`search_media`	Search for similar media across your indexed library.
`list_searches`	List previous searches on your account.

Media Management

Tool	Description
`register_media`	Register and index media with optional protection mode (register, search_ready, standard, maximum).
`list_media`	List media assets in your library (paginated, filterable).
`get_media`	Get details of a specific media asset including protection status and algorithms applied.
`update_media`	Update media metadata (e.g., original URL).
`delete_media`	Permanently delete a media asset and all associated data.

Account, Rights & Billing

Tool	Description
`get_account`	Get your account details — ID, name, email, credit balance, and plan info.
`get_rights`	Get C2PA, IPTC, and rights information for a media asset.
`get_billing`	View credit balance, usage breakdown, per-algorithm costs, and billing portal link.

Provenance & Identification

Tool	Description
`get_provenance`	Get the full provenance chain for an asset — algorithms, C2PA manifest, membership results.
`identify_media`	Identify media by its embedded Sidearm fingerprint and extract its C2PA provenance chain.

Tool	Description
`create_share`	Create a shareable link for a detection, search, or provenance result (starts private).
`get_share`	Get a shared result by its share ID.
`publish_share`	Make a shared result publicly accessible.

Deletion Records

Tool	Description
`list_deletions`	List deletion records documenting permanently deleted assets.
`get_deletion`	Get details of a specific deletion record including purged algorithms and storage status.

Documentation

Tool	Description
`search_docs`	Search the Sidearm API documentation. Returns relevant sections from the full developer reference.
`navigate_ui`	Look up how to perform actions in the Sidearm dashboard. Returns step-by-step instructions.

Example Agent Conversations

"Protect this image from AI training"

Agent calls protect_media with the image URL, then check_job to get the protected file.

"What algorithms are available for audio?"

Agent calls list_algorithms with media_type: "audio".

"Run Nightshade and Glaze on my artwork"

Agent calls run_algorithm with algorithms: ["nightshade", "glaze"].

"Is this photo AI-generated?"

Agent calls detect_ai with the image, then check_job for results.

"Was my artwork used to train Stable Diffusion?"

Agent calls detect_membership with your media IDs and the model name.

"How do I upload files in the dashboard?"

Agent calls navigate_ui with query: "upload files" for step-by-step instructions.

Environment Variables

Variable	Required	Description
`SDRM_API_KEY`	Yes	Your Sidearm API key (`sk_live_...` or `sk_test_...`)
`SDRM_BASE_URL`	No	Override the API base URL (default: `https://api.sdrm.io`)

Development

bash

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

Test locally with the MCP Inspector:

bash

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

License

MIT

常见问题