Audius용 Atris MCP

LLM(대규모 언어 모델)을 통해 Audius 음악 플랫폼에 대한 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

특징

도구 : Audius에서 트랙, 사용자, 재생 목록, 앨범에 액세스하고 검색을 수행합니다.
오디오 스트리밍 : Audius에서 AI 애플리케이션으로 오디오 콘텐츠를 직접 스트리밍합니다.
콘텐츠 생성 : 트랙 업로드, 재생 목록 생성, Audius 콘텐츠 관리
소셜 기능 : 사용자 팔로우, 트랙 즐겨찾기, 콘텐츠에 댓글 달기
수익 창출 : 프리미엄 콘텐츠에 액세스하고, 트랙을 구매하고, 아티스트에게 팁을 보냅니다.
분석 : 재생 횟수, 추세 데이터 및 청취자 통찰력 추적
리소스 : 구조화된 리소스로 트랙, 사용자, 재생 목록 및 앨범 데이터에 액세스합니다.
프롬프트 : 음악 발견, 큐레이션 및 분석을 위한 가이드 경험 활용

자연어 기능

Atris MCP를 사용하면 Audius 콘텐츠에 대한 LLM 질문을 자연어로 질문할 수 있습니다. 예시는 다음과 같습니다.

음악 발견

"BPM이 높은 일렉트로닉 트랙을 찾아주세요"
"이번 주 힙합 장르에서 가장 인기 있는 트랙은 무엇인가요?"
"[아티스트 이름]과 비슷한 아티스트 추천해줘"
"재즈 장르의 언더그라운드 아티스트를 발굴하는 데 도움을 주세요"
"명상 플레이리스트에 편안한 분위기의 트랙을 찾아보세요"

아티스트 정보

"[이름] 아티스트에 대해 알려주세요"
"[아티스트]의 가장 인기 있는 팔로워는 누구인가요?"
"[아티스트는] 최근에 어떤 트랙을 발매했나요?"
"[아티스트]의 가장 인기 있는 트랙에 대한 분석을 보여주세요"
"[아티스트 이름]과 비슷한 아티스트는 누구인가요?"

재생목록 관리

"쾌활한 일렉트로닉 트랙으로 플레이리스트를 만들어 보세요"
"내 운동 플레이리스트에 가장 인기 있는 힙합 트랙을 추가해줘"
"[이름] 재생목록에서 [제목] 트랙을 제거해 주세요."
"노래 사이의 흐름을 개선하기 위해 재생 목록을 재정렬하세요"
"파티를 위한 플레이리스트를 큐레이션하는 데 도움을 주세요"

트랙 분석

"[트랙]의 청취자 인구 통계를 분석합니다."
"[트랙]의 가장 큰 팬은 누구인가요?"
"[트랙]은 같은 장르의 다른 트랙과 비교했을 때 어떤 성과를 보이고 있나요?"
"[트랙]의 지난 한 달 청취 추세는 어땠나요?"
"[트랙]에 대한 참여 지표를 보여주세요"

콘텐츠 수익화

"내 새 트랙에 NFT 게이팅을 설정하세요"
"프리미엄 콘텐츠에 얼마를 청구해야 하나요?"
"내 팁 내역과 통계를 보여주세요"
"플랫폼 전반의 수익 흐름을 분석합니다"
"[콘텐츠] 구매 옵션을 이해하도록 도와주세요."

사회 및 커뮤니티 상호 작용

"내 음악에 자주 참여하는 팬을 찾으세요"
"내 최신 트랙에 대한 댓글 보여줘"
"[아티스트]와 협업할 메시지 작성 도와주세요"
"[장르] 분야에서 네트워크를 키우려면 누구를 팔로우해야 할까요?"
"내 소셜 참여를 분석하고 개선 사항을 제안해 주세요"
"나에게 가장 많은 팁을 준 팬을 찾아줘"
"알림 기록을 추적하고 중요한 알림의 우선순위를 지정하세요"

워크플로 자동화 및 크리에이티브 지원

"마케팅 타임라인을 통해 다음 트랙 발매를 계획하세요"
"내 청취 습관에 따라 매주 재생 목록을 자동으로 업데이트합니다."
"최적의 참여를 위해 콘텐츠 공지 일정을 정하세요"
"내 새로운 앰비언트 트랙에 대한 설명 태그를 생성하세요"
"내 장르 분류를 비슷한 아티스트들과 비교해 보세요"
"기존 카탈로그 성과를 기반으로 가격 책정 전략을 제안합니다."
"내 프로필에 매력적인 아티스트 소개를 작성하는 데 도움을 주세요"

필수 조건

Node.js 16 이상
Audius API 키(선택 사항이지만 프로덕션 용도로 권장됨)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Atris를 자동으로 설치하려면:

지엑스피1

NPM 설치(권장)

npm에서 직접 설치:

npm install audius-mcp-atris

또는 실로:

yarn add audius-mcp-atris

수동 설치

이 저장소를 복제하세요:

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

종속성 설치:

npm install

TypeScript 코드를 작성합니다.

npm run build

도커 설치

Docker를 사용하여 MCP 서버를 빌드하고 실행할 수도 있습니다.

Docker 이미지를 빌드합니다.

docker build -t audius-mcp-atris .

컨테이너를 실행합니다.

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

참고: AUDIUS_ENVIRONMENT를 "production"으로 설정하면 SDK가 로컬 노드를 사용하는 대신 공개 Audius 검색 노드에 연결됩니다.

Claude Desktop의 경우 Docker를 사용하도록 claude_mcp_config.json 구성합니다.

{
  "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"
      }
    }
  }
}

구성

제공된 .env.example 을 기반으로 루트 디렉토리에 .env 파일을 만듭니다.

# 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

용법

서버 실행

서버를 시작합니다:

npm start

이렇게 하면 기본 MCP 서버와 오디오 스트리밍 서버가 자동으로 시작됩니다. 오디오 스트리밍 서버는 기본적으로 7070 포트에서 실행됩니다(STREAM_SERVER_PORT 환경 변수를 통해 설정 가능).

테스트나 개발을 위해 스트리밍 서버만 시작해야 하는 경우:

node start-stream-server.js

클로드에 연결

Claude와 함께 이 서버를 사용하려면:

데스크톱 또는 Claude CLI 에 Claude 설치

NPX 설치(권장)

이 MCP 서버를 사용하는 가장 쉬운 방법은 npx를 사용하는 것입니다. npx를 사용하면 전역적으로 설치하지 않고도 패키지를 실행할 수 있습니다.

Claude CLI의 경우:

claude mcp add audius npx audius-mcp-atris

Claude Desktop의 경우:

claude_mcp_config.json 파일을 편집합니다(위치는 플랫폼마다 다릅니다).

macOS : ~/Library/Application Support/Claude/claude_mcp_config.json
윈도우 : %APPDATA%\Claude\claude_mcp_config.json
리눅스 : ~/.config/Claude/claude_mcp_config.json

다음 구성을 추가합니다.

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

기타 LLM 지원의 경우:

모델 컨텍스트 프로토콜을 지원하는 애플리케이션의 경우 해당 구성 파일에서 다음 구성을 사용하세요.

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

로컬 설치 방법

로컬 설치를 선호하는 경우:

# 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"
      }
    }
  }
}

사용 가능한 도구

서버는 다음과 같은 기능을 제공합니다.

디스커버리 도구

검색 : 다양한 필터를 사용하여 트랙, 사용자, 재생 목록을 찾으세요
고급 검색 : 장르, 분위기, BPM 등의 필터로 검색
트렌딩 검색 : 트렌딩 또는 언더그라운드 트랙을 찾아보세요
유사 아티스트 : 당신이 좋아하는 아티스트와 비슷한 아티스트를 찾아보세요

트랙 도구

트랙 스트리밍 : Audius 트랙에서 직접 오디오를 스트리밍합니다.
트랙 정보 가져오기 : ID별 자세한 트랙 정보
트랙 검색 : 다양한 필터로 트랙 찾기
인기 트랙 : Audius에서 인기 있는 곡을 알아보세요
트랙 코멘트 : 트랙에 대한 코멘트를 보고 추가합니다.
트랙 분석 : 청취 횟수, 추세 데이터, 청중 통찰력

사용자 도구

사용자 프로필 : 자세한 사용자 정보를 얻으세요
사용자 트랙 : 사용자가 업로드한 트랙 목록
사용자 팔로우 : 다른 사용자를 팔로우합니다
사용자 분석 : 플레이 지표, 서포터 등을 추적합니다.

콘텐츠 생성

트랙 업로드 : Audius에 새 트랙 추가
트랙 업데이트 : 기존 트랙 메타데이터 수정
재생 목록 만들기 : 트랙 컬렉션 구축
재생 목록 관리 : 트랙 추가, 제거 및 순서 변경

사회적 상호 작용

아티스트 팔로우 : 좋아하는 크리에이터와 소통하세요
즐겨찾는 트랙 : 음악에 대한 감상을 저장하고 표현하세요
댓글 : 트랙에 댓글을 추가합니다
리포스트 : 누가 콘텐츠를 리포스트했는지 확인하세요
메시징 : 직접 메시지 보내기 및 받기

수익화

프리미엄 콘텐츠 : 게이트된 콘텐츠에 액세스하고 구매하세요
NFT 게이트 콘텐츠 : NFT 기반 액세스 확인 및 검증
트랙 구매 : 다양한 결제 옵션을 통해 프리미엄 콘텐츠를 구매하세요
팁 보내기 : 아티스트를 직접 지원하세요
거래 추적 : 팁 내역 및 통계 보기

블록체인 및 지갑

지갑 관리 : 이더리움 및 솔라나 지갑 관리
토큰 잔액 : 암호화폐 잔액 확인
거래 : 내역 보기 및 이체 실행
보상 : Audius 플랫폼 보상 및 챌린지에 참여하세요

자원

다음 URI 템플릿을 사용하여 Audius 데이터에 액세스하세요.

audius://track/{id} : ID별 트랙 세부 정보
audius://user/{id} : ID별 사용자 프로필
audius://playlist/{id} : ID별 재생 목록 세부 정보
audius://album/{id} : ID별 앨범 세부정보

프롬프트

이 서버는 일반적인 음악 관련 작업에 대한 가이드 경험을 제공합니다.

음악 검색 : 선호도에 따른 추천을 찾아보세요
트랙 분석 : 트랙 특성을 분석하고 통찰력을 얻으세요
아티스트 프로필 : 포괄적인 아티스트 개요 생성
음악 제작 : 트랙 제작 및 게시 지원
플레이리스트 큐레이션 : 플레이리스트 생성 및 홍보 지원
메시징 : 다른 사용자와의 상호작용 안내
분석 : 음악 성과에 대한 보고서와 통찰력을 생성합니다.
블록체인 : 암호화폐 및 토큰 운영 지원
수익 창출 : 프리미엄 콘텐츠 설정 및 구매 안내
알림 : 플랫폼 알림을 관리하고 구성합니다.

개발

프로젝트 구조

├── 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

예제 워크플로

음악 발견

// 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"

콘텐츠 생성

// 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"]

소셜 기능

// 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!"

수익화

// 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"

테스트

로컬 개발 테스트의 경우:

MCP 검사기 설치 :

npm install -g @modelcontextprotocol/inspector

서버에서 검사기를 실행하세요.

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

특허

MIT

Audius용 Atris MCP

특징

자연어 기능

음악 발견

아티스트 정보

재생목록 관리

트랙 분석

콘텐츠 수익화

사회 및 커뮤니티 상호 작용

워크플로 자동화 및 크리에이티브 지원

필수 조건

설치

Smithery를 통해 설치

NPM 설치(권장)

수동 설치

도커 설치

구성

용법

서버 실행

클로드에 연결

NPX 설치(권장)

Claude CLI의 경우:

Claude Desktop의 경우:

기타 LLM 지원의 경우:

로컬 설치 방법

사용 가능한 도구

디스커버리 도구

트랙 도구

사용자 도구

콘텐츠 생성

사회적 상호 작용

수익화

블록체인 및 지갑

자원

프롬프트

개발

프로젝트 구조

예제 워크플로

음악 발견

콘텐츠 생성

소셜 기능

수익화

테스트

특허

Related Resources

Appeared in Searches