@amana/mcp-shelf

MCP (Model Context Protocol) server for the amana Shelf service — a digital asset management platform for images, video, audio, and documents.

Overview

This package exposes the Shelf API as MCP tools, allowing AI agents (Claude, Cursor, Dify, Compy, etc.) to search, retrieve, and manage digital assets via natural language.

Installation

npm install @amana/mcp-shelf
# or
npx @amana/mcp-shelf

Requirements

| Environment Variable | Description | Required | |---|---|---| | AMANA_API_KEY | Your amana platform API key | ✅ | | AMANA_API_BASE_URL | Base URL of the amana gateway | ✅ |

Configuration

Claude Desktop / Cursor

Add to your claude_desktop_config.json or Cursor MCP settings:

{
  "mcpServers": {
    "amana-shelf": {
      "command": "npx",
      "args": ["@amana/mcp-shelf"],
      "env": {
        "AMANA_API_KEY": "amana_key_xxxxxxxx",
        "AMANA_API_BASE_URL": "https://api.amana.io"
      }
    }
  }
}

Compy

In Compy's MCP configuration panel, add:

• Command: npx @amana/mcp-shelf
• Env: Set AMANA_API_KEY and AMANA_API_BASE_URL

Available Tools

| Tool Name | Description | |---|---| | shelf_search_assets | Search for assets by keyword and type (image, video, audio, document) | | shelf_get_asset | Get detailed metadata for a specific asset by ID | | shelf_create_asset | Register a new asset in Shelf after file upload |

Example Usage (Natural Language)

"Search for landscape images in Shelf with keyword 'mountain'"

"Get the details of asset ID ast_abc123"

"Register the uploaded file file_xyz as a video asset named 'Product Demo'"

Related Packages

• @amana/mcp-files — Upload files to amana storage
• @amana/mcp-qosmo — AI music generation for video

License

MIT © amana Inc.