Mureka MCP Server

강력한 가사, 노래 및 배경 음악 생성 API와 상호 작용할 수 있는 공식 Mureka 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 Claude Desktop, OpenAI Agents 등의 MCP 클라이언트가 가사, 노래 및 배경 음악(기악)을 생성할 수 있습니다.

Claude Desktop 빠른 시작

1. Mureka에서 API 키를 발급받으세요.
2. uv(Python 패키지 관리자)를 설치하고, curl -LsSf https://astral.sh/uv/install.sh | sh로 설치하거나 추가 설치 방법은 uv 저장소를 참조하세요.
3. Claude > 설정 > 개발자 > 구성 편집 > claude_desktop_config.json으로 이동하여 다음을 포함시키세요:

{
    "mcpServers": {
        "Mureka": {
            "command": "uvx",
            "args": [
                "mureka-mcp"
            ],
            "env": {
                "MUREKA_API_KEY": "<insert-your-api-key-here>",
                "MUREKA_API_URL": "https://api.mureka.ai",
                "TIME_OUT_SECONDS":"300"
            }
        }
    }
}

그런 다음 Claude 앱을 다시 시작하면 창에 4개의 MCP 도구가 표시되어 성공적으로 로드되었음을 나타냅니다.

선택적 기능

claude_desktop_config.json에 TIME_OUT_SECONDS 환경 변수를 추가하여 노래 또는 배경 음악 생성 대기 시간 제한을 설정할 수 있습니다(기본값 60초).

사용 예시

⚠️ 경고: 이 도구를 사용하려면 Mureka 크레딧이 필요합니다. Claude에게 다음과 같이 요청해 보세요:

• "제 딸 Jessica를 위해 생일 축하 노래를 만들어서 재생해 주세요"

• "크리스마스에 관한 가사를 생성해 주세요"
• "방금 만든 가사를 바탕으로 노래를 생성해 주세요"
• "커피숍에서 틀기 좋은 배경 음악을 생성해 주세요"

bgm 1 다운로드

bgm 2 다운로드

문제 해결

Claude Desktop 실행 시 로그는 다음 위치에서 확인할 수 있습니다:

• Windows: %APPDATA%\Claude\logs\mcp-server-Mureka.log
• macOS: ~/Library/Logs/Claude/mcp-server-Mureka.log

Openai agents sdk 빠른 시작

Agents SDK 설치

pip install openai-agents

예제 실행: openapi_agents_example/main.py

키를 반드시 입력해야 합니다:

MUREKA_API_KEY = "<insert-your-api-key-here>"

실행 후 콘솔에서 작곡 과정을 확인할 수 있습니다.