Sidearm

@sidearmdrm/mcp

Sidearm API 的 MCP 服务 — 保护媒体免受 AI 训练、检测 AI 生成内容，并搜索被盗作品。

此软件包将 Sidearm REST API 封装为 Model Context Protocol（MCP）工具，AI Agent（Cursor、Claude Desktop、Windsurf 等）可直接调用这些工具。

快速开始

1. 获取 API 密钥

在 sdrm.io 注册，并在 sdrm.io/api-keys 创建 API 密钥。

2. 配置 Agent

将以下内容添加到 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_..."
      }
    }
  }
}

完成。现在，你的 Agent 可以调用 Sidearm 工具了。

工具（27 个）

发现

工具	描述
list_algorithms	浏览可用的保护算法。可按类别或媒体类型筛选。

保护与提取

工具	描述
run_algorithm	根据媒体 ID 运行指定算法。返回一个用于异步处理的作业。
protect_media	使用预设级别（standard/maximum）保护媒体。自动选择算法。
extract_embeddings	从媒体中提取原始嵌入向量，用于下游相似度搜索或机器学习流程。

作业

工具	描述
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 控制面板中执行操作。返回分步说明。

Agent 对话示例

“保护这张图片，避免其用于 AI 训练”

Agent 使用图片 URL 调用 protect_media，然后调用 check_job 获取受保护的文件。

“有哪些可用于音频的算法？”

Agent 使用 media_type: "audio" 调用 list_algorithms。

“对我的作品运行 Nightshade 和 Glaze”

Agent 使用 algorithms: ["nightshade", "glaze"] 调用 run_algorithm。

“这张照片是 AI 生成的吗？”

Agent 使用图片调用 detect_ai，然后调用 check_job 获取结果。

“我的作品是否被用于训练 Stable Diffusion？”

Agent 使用你的媒体 ID 和模型名称调用 detect_membership。

“如何在控制面板中上传文件？”

Agent 使用 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