Atris MCP para Audius

Un servidor MCP (Protocolo de contexto de modelo) que proporciona acceso a la plataforma de música Audius a través de LLM (modelos de lenguaje grandes).

Características

Herramientas : Accede a pistas, usuarios, listas de reproducción, álbumes y realiza búsquedas en Audius
Transmisión de audio : transmita contenido de audio directamente desde Audius a aplicaciones de IA
Creación de contenido : sube pistas, crea listas de reproducción, administra tu contenido de Audius
Funciones sociales : seguir a usuarios, marcar pistas como favoritas, comentar contenido
Monetización : accede a contenido premium, compra pistas, envía propinas a los artistas
Análisis : seguimiento de los recuentos de reproducciones, datos de tendencias e información de los oyentes
Recursos : acceda a datos de pistas, usuarios, listas de reproducción y álbumes como recursos estructurados
Indicaciones : utilice experiencias guiadas para el descubrimiento, la selección y el análisis de música

Capacidades del lenguaje natural

Con Atris MCP, puedes formular tus preguntas de LLM en lenguaje natural sobre el contenido de Audius. Algunos ejemplos son:

Descubrimiento musical

"Encuéntrame pistas electrónicas con un BPM alto"
"¿Cuáles son las canciones de tendencia en el género hip-hop esta semana?"
"Recomendar artistas similares a [nombre del artista]"
Ayúdame a descubrir artistas underground del género jazz.
Encuentra pistas relajantes para una lista de reproducción de meditación.

Información del artista

"Cuéntame sobre el artista [nombre]"
"¿Quiénes son los seguidores más populares de [artista]?"
"¿Qué canciones ha lanzado [artista] recientemente?"
"Muéstrame las estadísticas de las canciones más populares de [artista]"
"¿Qué artistas son similares a [nombre del artista]?"

Gestión de listas de reproducción

"Crea una lista de reproducción de temas electrónicos animados"
Añade las canciones de hip-hop más populares a mi lista de reproducción para entrenar.
"Eliminar la pista [título] de mi lista de reproducción [nombre]"
"Reordenar mi lista de reproducción para que fluya mejor entre las canciones"
"Ayúdame a crear una lista de reproducción para una fiesta"

Análisis de pista

Analizar la demografía de los oyentes de [pista]
"¿Quiénes son los principales fans de [pista]?"
"¿Cómo se desempeña [la pista] en comparación con otras pistas de su género?"
"¿Cuál es la tendencia de escucha de [pista] durante el último mes?"
"Muéstrame las métricas de interacción de [pista]"

Monetización de contenido

Configurar la puerta NFT para mi nueva pista
"¿Cuánto debo cobrar por mi contenido premium?"
"Muéstrame mi historial de propinas y mis estadísticas"
Analizar mis flujos de ingresos en toda la plataforma.
"Ayúdame a entender las opciones de compra de [contenido]"

Interacciones sociales y comunitarias

"Encontrar fans que interactúen frecuentemente con mi música"
"Muéstrame los comentarios de mi última canción"
"Ayúdame a redactar un mensaje para colaborar con [artista]"
"¿A quién debería seguir para hacer crecer mi red en la escena [del género]?"
Analizar mi interacción social y sugerir mejoras.
"Encuentra a los fans más solidarios que me han dado propina"
"Sigue mi historial de notificaciones y prioriza las importantes"

Automatización del flujo de trabajo y asistencia creativa

Planificar el lanzamiento de mi próximo tema con un cronograma de marketing.
"Automatizar las actualizaciones semanales de la lista de reproducción según mis hábitos de escucha"
Programar anuncios de contenido para optimizar la interacción.
Generar etiquetas descriptivas para mi nueva pista ambiental
"Compara mi categorización de género con artistas similares"
"Sugerir una estrategia de precios basada en el rendimiento de mi catálogo actual"
Ayúdame a crear una biografía de artista atractiva para mi perfil.

Prerrequisitos

Node.js 16 o superior
Una clave API de Audius (opcional, pero recomendada para uso en producción)

Instalación

Instalación mediante herrería

Para instalar Atris para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @glassBead-tc/audius-mcp-atris --client claude

Instalación de NPM (recomendada)

Instalar directamente desde npm:

npm install audius-mcp-atris

O con hilo:

yarn add audius-mcp-atris

Instalación manual

Clonar este repositorio:

git clone https://github.com/glassBead/audius-mcp-atris.git
cd audius-mcp-atris

Instalar dependencias:

npm install

Construya el código TypeScript:

npm run build

Instalación de Docker

También puedes construir y ejecutar el servidor MCP usando Docker:

Construya la imagen de Docker:

docker build -t audius-mcp-atris .

Ejecute el contenedor:

docker run -it --rm \
  -e AUDIUS_API_KEY=your_api_key_here \
  -e AUDIUS_API_SECRET=your_api_secret_here \
  -e AUDIUS_ENVIRONMENT=production \
  audius-mcp-atris

Nota: Configurar AUDIUS_ENVIRONMENT en "producción" garantiza que el SDK se conecte a los nodos de descubrimiento públicos de Audius en lugar de intentar usar nodos locales.

Para Claude Desktop, configure su claude_mcp_config.json para usar Docker:

{
  "mcpServers": {
    "audius": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "audius-mcp-atris"
      ],
      "env": {
        "AUDIUS_API_KEY": "your_api_key_here",
        "AUDIUS_API_SECRET": "your_api_secret_here",
        "AUDIUS_ENVIRONMENT": "production"
      }
    }
  }
}

Configuración

Cree un archivo .env en el directorio raíz basándose en el .env.example proporcionado:

# Audius API Configuration
AUDIUS_API_KEY=your_api_key_here
AUDIUS_API_SECRET=your_api_secret_here
AUDIUS_ENVIRONMENT=production # or staging, development

# MCP Server Configuration
SERVER_NAME=audius-mcp
SERVER_VERSION=1.0.0

Uso

Ejecución del servidor

Iniciar el servidor:

npm start

Esto iniciará automáticamente tanto el servidor MCP principal como el servidor de streaming de audio. El servidor de streaming de audio se ejecuta en el puerto 7070 de forma predeterminada (configurable mediante la variable de entorno STREAM_SERVER_PORT).

Si necesita iniciar solo el servidor de transmisión para pruebas o desarrollo:

node start-stream-server.js

Conectando con Claude

Para utilizar este servidor con Claude:

Instalar Claude para escritorio o Claude CLI

Instalación de NPX (recomendada)

La forma más sencilla de utilizar este servidor MCP es con npx, que puede ejecutar el paquete sin instalarlo globalmente:

Para Claude CLI:

claude mcp add audius npx audius-mcp-atris

Para Claude Desktop:

Edite su archivo claude_mcp_config.json (la ubicación varía según la plataforma):

macOS : ~/Library/Application Support/Claude/claude_mcp_config.json
Ventanas : %APPDATA%\Claude\claude_mcp_config.json
Linux : ~/.config/Claude/claude_mcp_config.json

Añade esta configuración:

{
  "mcpServers": {
    "audius": {
      "command": "npx",
      "args": [
        "audius-mcp-atris"
      ],
      "env": {
        "AUDIUS_API_KEY": "your_api_key_here",
        "AUDIUS_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

Para otras solicitudes de LLM:

Para las aplicaciones que admiten el Protocolo de contexto de modelo, utilice esta configuración en sus respectivos archivos de configuración:

{
  "audius": {
    "command": "npx",
    "args": [
      "audius-mcp-atris"
    ],
    "env": {
      "AUDIUS_API_KEY": "your_api_key_here",
      "AUDIUS_API_SECRET": "your_api_secret_here"
    }
  }
}

Método de instalación local

Si prefiere una instalación local:

# Install the package globally
npm install -g audius-mcp-atris

# Then configure Claude CLI
claude mcp add audius audius-mcp-atris

# Or for Claude Desktop, use this in your config:
{
  "mcpServers": {
    "audius": {
      "command": "audius-mcp-atris",
      "env": {
        "AUDIUS_API_KEY": "your_api_key_here",
        "AUDIUS_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

Herramientas disponibles

El servidor proporciona la siguiente funcionalidad:

Herramientas de descubrimiento

Buscar : Encuentra pistas, usuarios, listas de reproducción con varios filtros
Búsqueda avanzada : busque por género, estado de ánimo, BPM y otros filtros
Descubrimiento de tendencias : descubre pistas de tendencia o underground
Artistas similares : Encuentra artistas similares a los que te gustan

Herramientas de seguimiento

Stream Track : Transmite audio directamente desde pistas de Audius
Obtener información de la pista : información detallada de la pista por ID
Buscar pistas : Encuentra pistas con varios filtros
Temas en tendencia : descubre lo que está de moda en Audius
Comentarios de pistas : ver y agregar comentarios sobre las pistas
Análisis de pistas : recuentos de escuchas, datos de tendencias, información sobre la audiencia

Herramientas de usuario

Perfiles de usuario : obtenga información detallada del usuario
Pistas de usuario : lista de pistas cargadas por un usuario
Seguir usuario : Seguir a otros usuarios
Análisis de usuarios : seguimiento de métricas de juego, seguidores y más

Creación de contenido

Subir pista : añade nuevas pistas a Audius
Actualizar pista : modificar los metadatos de la pista existente
Crear lista de reproducción : crea colecciones de pistas
Gestión de listas de reproducción : añadir, eliminar y reordenar pistas

Seguir artistas : Conéctate con tus creadores favoritos
Pistas favoritas : guarda y muestra tu aprecio por la música
Comentarios : Agregar comentarios a las pistas
Reposts : vea quién ha republicado contenido
Mensajería : Enviar y recibir mensajes directos

Monetización

Contenido Premium : Accede y compra contenido restringido
Contenido controlado por NFT : comprobar y verificar el acceso basado en NFT
Comprar pistas : compra contenido premium con varias opciones de pago
Enviar propinas : Apoya a los artistas directamente
Seguimiento de transacciones : ver historial de propinas y estadísticas

Blockchain y billetera

Gestión de billeteras : administre billeteras Ethereum y Solana
Saldos de tokens : Consulta los saldos de criptomonedas
Transacciones : Ver historial y ejecutar transferencias
Recompensas : Accede a las recompensas y desafíos de la plataforma Audius

Recursos

Acceda a los datos de Audius utilizando estas plantillas URI:

audius://track/{id} : Detalles de la pista por ID
audius://user/{id} : Perfil de usuario por ID
audius://playlist/{id} : Detalles de la lista de reproducción por ID
audius://album/{id} : Detalles del álbum por ID

Indicaciones

El servidor ofrece experiencias guiadas para tareas comunes relacionadas con la música:

Descubrimiento musical : encuentre recomendaciones basadas en preferencias
Análisis de pista : analiza las características de la pista y obtén información
Perfiles de artistas : genere descripciones generales completas de los artistas
Creación musical : ayuda con la creación y publicación de pistas
Curación de listas de reproducción : ayuda para crear y promocionar listas de reproducción
Mensajería : Guía las interacciones con otros usuarios
Análisis : genere informes y conocimientos sobre el rendimiento musical
Blockchain : ayuda con las operaciones con criptomonedas y tokens
Monetización : Guía para la configuración y compra de contenido premium
Notificaciones : Administra y organiza las notificaciones de la plataforma.

Desarrollo

Estructura del proyecto

├── src/
│   ├── index.ts          # Entry point
│   ├── server.ts         # MCP server setup
│   ├── config.ts         # Configuration handling
│   ├── sdk-client.ts     # Audius SDK client wrapper
│   ├── tools/            # MCP tool implementations
│   │   ├── tracks.ts               # Track-related tools
│   │   ├── users.ts                # User-related tools
│   │   ├── playlists.ts            # Playlist-related tools
│   │   ├── search.ts               # Search-related tools
│   │   ├── social.ts               # Social interaction tools
│   │   ├── comments.ts             # Comment management tools
│   │   ├── track-management.ts     # Track upload and management
│   │   ├── playlist-management.ts  # Playlist creation and management
│   │   ├── messaging.ts            # Direct messaging tools
│   │   ├── analytics.ts            # Analytics and metrics tools
│   │   ├── blockchain.ts           # Cryptocurrency and blockchain tools
│   │   ├── monetization.ts         # Premium content and payment tools
│   │   └── notifications.ts        # Platform notification tools
│   ├── resources/        # MCP resource implementations
│   │   ├── tracks.ts     # Track-related resources
│   │   ├── users.ts      # User-related resources
│   │   └── playlists.ts  # Playlist-related resources
│   └── prompts/          # MCP prompt implementations
│       ├── music-search.ts      # Music discovery prompts
│       ├── track-info.ts        # Track analysis prompts
│       ├── artist-profile.ts    # Artist profile prompts
│       ├── music-creation.ts    # Music creation prompts
│       ├── playlist-creation.ts # Playlist creation prompts
│       ├── messaging.ts         # Messaging prompts
│       ├── analytics.ts         # Analytics prompts
│       ├── blockchain.ts        # Blockchain prompts
│       ├── monetization.ts      # Monetization prompts
│       └── notifications.ts     # Notification prompts

Flujos de trabajo de ejemplo

Descubrimiento musical

// Search for electronic tracks
search-tracks --query "electronic" --limit 5

// Stream an audio track
stream-track --trackId "123456"

// Get trending tracks in a genre
get-trending-tracks --genre "House" --limit 10

// Find artists similar to a specific one
similar-artists --userId "123456"

Creación de contenido

// Upload a new track
upload-track --userId "123" --title "Summer Vibes" --genre "Electronic" --audioFileUrl "https://example.com/track.mp3"

// Create a playlist
create-playlist --userId "123" --playlistName "Chillout Mix" --description "Perfect for relaxing"

// Add tracks to a playlist
add-tracks-to-playlist --userId "123" --playlistId "456" --trackIds ["789", "101", "102"]

Características sociales

// Follow a user
follow-user --userId "123" --followeeId "456"

// Favorite a track
favorite-track --userId "123" --trackId "789"

// Add a comment
add-track-comment --trackId "789" --userId "123" --comment "Great track!"

Monetización

// Check track access gates
track-access-gates --trackId "789"

// View purchase options
purchase-options --contentId "789" --contentType "track"

// Purchase a track
purchase-track --contentId "789" --walletAddress "0x123..." --purchaseOption "option1" --paymentToken "USDC" --amount "4.99" --signerPrivateKey "privateKey"

Pruebas

Para pruebas de desarrollo local:

Instalar el Inspector MCP :

npm install -g @modelcontextprotocol/inspector

Ejecute el inspector con su servidor:

npx @modelcontextprotocol/inspector node ./build/index.js

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Atris MCP para Audius

Características

Capacidades del lenguaje natural

Descubrimiento musical

Información del artista

Gestión de listas de reproducción

Análisis de pista

Monetización de contenido

Interacciones sociales y comunitarias

Automatización del flujo de trabajo y asistencia creativa

Prerrequisitos

Instalación

Instalación mediante herrería

Instalación de NPM (recomendada)

Instalación manual

Instalación de Docker

Configuración

Uso

Ejecución del servidor

Conectando con Claude

Instalación de NPX (recomendada)

Para Claude CLI:

Para Claude Desktop:

Para otras solicitudes de LLM:

Método de instalación local

Herramientas disponibles

Herramientas de descubrimiento

Herramientas de seguimiento

Herramientas de usuario

Creación de contenido

Interacción social

Monetización

Blockchain y billetera

Recursos

Indicaciones

Desarrollo

Estructura del proyecto

Flujos de trabajo de ejemplo

Descubrimiento musical

Creación de contenido

Características sociales

Monetización

Pruebas

Licencia

Related Resources

Appeared in Searches