使用说明
@侧臂drm/mcp
MCP服务器 API侧臂 --保护媒体免受人工智能训练,检测人工智能生成的内容,并搜索被盗作品。
此包将Sidearm REST API公开为 模型上下文协议 AI代理(Cursor、Claude Desktop、Windsurf等)可以直接调用的(MCP)工具。
快速开始
1.获取API密钥
注册地址: sdm.io 并在以下位置创建API密钥 sdm.io/api-keys.
2.配置您的代理
添加到MCP配置文件中:
光标 (.cursor/mcp.json):
{
"mcpServers": {
"sdrm": {
"command": "npx",
"args": ["-y", "@sidearmdrm/mcp"],
"env": {
"SDRM_API_KEY": "sk_live_..."
}
}
}
}
克劳德桌面版 (claude_desktop_config.json):
{
"mcpServers": {
"sdrm": {
"command": "npx",
"args": ["-y", "@sidearmdrm/mcp"],
"env": {
"SDRM_API_KEY": "sk_live_..."
}
}
}
}
帆板运动 (~/.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 |
使用预设级别(标准/最大)保护媒体。自动选择算法。 |
extract_embeddings |
从媒体中提取原始嵌入向量,用于下游相似性搜索或机器学习管道。 |
工作
| 工具 | 说明 |
|---|---|
check_job |
轮询异步作业状态。完成后返回进度和结果。 |
检测
| 工具 | 说明 |
|---|---|
detect_ai |
检测媒体是否由人工智能生成。支持图像、视频、音频和文本。 |
detect_fingerprint |
检查媒体之前是否已使用指纹匹配注册。 |
detect_membership |
测试你的内容是否被用来训练可疑的人工智能模型。 |
搜索
| 工具 | 说明 |
|---|---|
search_media |
在索引库中搜索类似的媒体。 |
list_searches |
列出您帐户上以前的搜索。 |
媒体管理
| 工具 | 说明 |
|---|---|
register_media |
使用可选保护模式(注册、搜索就绪、标准、最大)注册和索引媒体。 |
list_media |
列出库中的媒体资源(分页、可过滤)。 |
get_media |
获取特定媒体资产的详细信息,包括保护状态和应用的算法。 |
update_media |
更新媒体元数据(例如,原始URL)。 |
delete_media |
永久删除媒体资产和所有相关数据。 |
帐户、权限和账单
| 工具 | 说明 |
|---|---|
get_account |
获取您的帐户详细信息——ID、姓名、电子邮件、信用余额和计划信息。 |
get_rights |
获取媒体资产的C2PA、IPTC和权限信息。 |
get_billing |
查看信用余额、使用明细、每算法成本和计费门户链接。 |
来源与识别
| 工具 | 说明 |
|---|---|
get_provenance |
获取资产的完整来源链——算法、C2PA清单、成员结果。 |
identify_media |
通过嵌入的侧臂指纹识别介质,并提取其C2PA来源链。 |
股份
| 工具 | 说明 |
|---|---|
create_share |
为检测、搜索或来源结果创建可共享的链接(从私有开始)。 |
get_share |
通过共享ID获取共享结果 |
publish_share |
使共享结果可公开访问。 |
删除记录
| 工具 | 说明 |
|---|---|
list_deletions |
列出记录永久删除资产的删除记录。 |
get_deletion |
获取特定删除记录的详细信息,包括已清除的算法和存储状态。 |
文档
| 工具 | 说明 |
|---|---|
search_docs |
搜索Sidearm API文档。返回完整开发人员参考中的相关部分。 |
navigate_ui |
在Sidearm仪表板中查找如何执行操作。返回分步说明。 |
代理对话示例
“保护此图像免受人工智能训练”
客服电话
protect_media使用图像URL,然后check_job以获取受保护的文件。
“音频有哪些算法?”
客服电话
list_algorithms随着media_type: "audio".
“在我的艺术品上运行Nightshade和Glaze”
客服电话
run_algorithm随着algorithms: ["nightshade", "glaze"].
“这张照片是人工智能生成的吗?”
客服电话
detect_ai有了图像,然后check_job为了获得结果。
“我的艺术作品是用来训练稳定扩散的吗?”
客服电话
detect_membership使用您的媒体ID和型号名称。
“如何在仪表板中上传文件?”
客服电话
navigate_ui随着query: "upload files"获取分步说明。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
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检查员:
SDRM_API_KEY=sk_test_... npx @modelcontextprotocol/inspector node dist/index.js
许可证
麻省理工学院