Iconik MCP服务器
模型上下文协议（MCP）服务器 Iconik 媒体资产管理API。这使得像克劳德这样的人工智能助手能够与您的Iconik媒体库进行交互。
特性
- 143 MCP工具 -全面覆盖Iconik API
- 多配置文件支持 -管理多个Iconik域/帐户
- 独立脚本 -用于常见批量操作的CLI工具
- 干运行模式 -安全地预览破坏性操作
安装
# Clone the repository
git clone https://github.com/postforward/Iconik-MCP-Server.git
cd Iconik-MCP-Server
# Install dependencies
npm install
# Build
npm run build配置
选项1：配置文件（建议用于多个配置文件）
创建 iconik-config.json 在项目目录中：
{
"default_profile": "production",
"profiles": {
"production": {
"name": "Production Domain",
"app_id": "your-app-id",
"auth_token": "your-auth-token"
},
"staging": {
"name": "Staging Domain",
"app_id": "your-staging-app-id",
"auth_token": "your-staging-auth-token",
"api_url": "https://preview.iconik.cloud/API/"
}
}
}在以下位置搜索配置文件：
- 当前工作目录：
./iconik-config.json - 主目录：
~/.iconik-config.json - 包目录
选项2：环境变量
对于单个配置文件，使用环境变量：
export ICONIK_APP_ID=your-app-id
export ICONIK_AUTH_TOKEN=your-auth-token
export ICONIK_API_URL=https://app.iconik.io/API/ # Optional或者创建一个 .env 文件：
ICONIK_APP_ID=your-app-id
ICONIK_AUTH_TOKEN=your-auth-token跑步
标准（默认）
对于本地使用Claude Code、Cursor、Claude Desktop和其他MCP客户端：
node dist/index.js超文本传输协议
对于通过Streamable HTTP进行的远程或容器化部署：
MCP_TRANSPORT=http node dist/index.js终点：
POST /mcp--MCP协议（新会话或现有通过mcp-session-id头球GET /mcp--现有会话的SSE流DELETE /mcp--结束会话GET /health--健康检查
访问级别
MCP_ACCESS_LEVEL 控制启动时注册哪些工具。默认为 read 为了安全。
| 级别 | 工具 | 计数 |
|---|---|---|
read | 列表、获取、搜索、检查 | 85 |
readwrite | 读取+创建、更新、批量 | 126 |
full | 读写+删除、清除 | 143 |
# Read-only (default)
node dist/index.js
# Read + write
MCP_ACCESS_LEVEL=readwrite node dist/index.js
# Full access
MCP_ACCESS_LEVEL=full node dist/index.js码头工人
# Build and run (read-only by default)
docker compose up --build
# With write access
MCP_ACCESS_LEVEL=readwrite docker compose up --build
# Full access
MCP_ACCESS_LEVEL=full docker compose up --build环境变量：
ICONIK_APP_ID（必填）ICONIK_AUTH_TOKEN（必填）MCP_ACCESS_LEVEL（默认值read)MCP_PORT（默认值8000)
使用Claude Desktop
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"iconik": {
"command": "node",
"args": ["/path/to/Iconik-MCP-Server/dist/index.js"],
"env": {
"ICONIK_APP_ID": "your-app-id",
"ICONIK_AUTH_TOKEN": "your-auth-token",
"MCP_ACCESS_LEVEL": "readwrite"
}
}
}
}然后重新启动Claude Desktop。
MCP工具
服务器提供按类别组织的工具：
资产
search_assets-使用筛选器搜索资产get_asset-获取资产详细信息create_asset-创建新资产update_asset-更新资产属性delete_asset-删除资产get_asset_proxies-列出代理文件delete_proxies_by_collection-批量删除代理- 还有30多种资产工具。..
集合
list_collections-列出所有收藏get_collection-获取收藏详细信息create_collection-创建收藏get_collection_contents-列出收藏内容add_to_collection-将资产添加到集合
元数据
get_asset_metadata-获取资产元数据update_asset_metadata-更新元数据值list_metadata_views-列出可用视图get_metadata_view-获取视图架构
文件和存储
list_storages-列出存储位置get_asset_files-列出资产文件create_file-创建文件记录
工作和转码
list_jobs-列出转码作业get_job-获取作业状态create_transcode_job-开始转码
用户和共享
list_users-列出用户list_shares-列出共享链接create_share-创建共享链接
独立脚本
直接运行脚本进行批量操作：
智能搜索
npx ts-node scripts/smart-search.ts search "interview" --type=video --transcripts
npx ts-node scripts/smart-search.ts export "*" ./all-assets.csv --limit=500
npx ts-node scripts/smart-search.ts recent --limit=10 --profile=staging删除代理
# Dry run (preview)
npx ts-node scripts/delete-proxies.ts collection
# Actually delete
npx ts-node scripts/delete-proxies.ts collection --live
# Use specific profile
npx ts-node scripts/delete-proxies.ts collection --profile=production --live存储审核
npx ts-node scripts/storage-audit.ts
npx ts-node scripts/storage-audit.ts --profile=production存档健康报告
npx ts-node scripts/archive-health-report.ts批量元数据更新
# List available metadata views
npx ts-node scripts/metadata-bulk-update.ts list-views
# Update by collection (dry run)
npx ts-node scripts/metadata-bulk-update.ts collection '{"field":"value"}'
# Update from CSV
npx ts-node scripts/metadata-bulk-update.ts csv ./updates.csv --live获取您的Iconik证书
- 登录您的Iconik域名
- 首选 管理员 → 设置 → 应用程序
- 创建新应用程序或使用现有应用程序
- 复制 应用程序ID 并生成 身份验证令牌
API 参考
此MCP服务器包装 API Iconik。有关详细的端点信息，请参阅他们的文档。
许可证
国际协调委员会
贡献
欢迎投稿！请打开问题或PR。