sync: ci: unify all workflow secrets to BOT_TOKEN

Synced from monorepo directory: suno

Author: acedatacloud-dev

.github/workflows/publish.yml

@@ -386,3 +386,30 @@ jobs:
             fi
             exit 1
           }
+
+  publish-dockerhub:
+    name: Publish to Docker Hub
+    if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
+    needs: [build]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: |
+            acedatacloud/mcp-suno:${{ needs.build.outputs.version }}
+            acedatacloud/mcp-suno:latest
+          platforms: linux/amd64,linux/arm64

README.md

@@ -134,7 +134,7 @@ Add to your VS Code MCP config (`.vscode/mcp.json`):
 }
 ```
 
-Or install the [Ace Data Cloud MCP extension](https://marketplace.visualstudio.com/items?itemName=acedatacloud.acedatacloud-mcp) for VS Code, which bundles all 11 MCP servers with one-click setup.
+Or install the [Ace Data Cloud MCP extension](https://marketplace.visualstudio.com/items?itemName=acedatacloud.acedatacloud-mcp) for VS Code, which bundles all 15 MCP servers with one-click setup.
 
 #### JetBrains IDEs
 
@@ -472,8 +472,8 @@ Options:
 
 ```bash
 # Clone repository
-git clone https://github.com/AceDataCloud/mcp-suno.git
-cd mcp-suno
+git clone https://github.com/AceDataCloud/SunoMCP.git
+cd SunoMCP
 
 # Create virtual environment
 python -m venv .venv

core/oauth.py

@@ -42,7 +42,7 @@
 # Initialize FastMCP server
 mcp = FastMCP(
     settings.server_name,
-    icons=[Icon(src="https://cdn.acedata.cloud/l3ffw7.jpg")],
+    icons=[Icon(src="https://cdn.acedata.cloud/l3ffw7.jpg", mimeType="image/jpeg")],
     **mcp_kwargs,
 )
 

core/server.py

@@ -31,12 +31,31 @@ def _with_task_guidance(
     if not task_id:
         return payload
 
-    payload["mcp_task_polling"] = {
-        "task_id": task_id,
-        "poll_tool": poll_tool,
-        "batch_poll_tool": batch_poll_tool,
-        "next_step": f'If the task is still pending or processing, call {poll_tool}(task_id="{task_id}") again later.',
-    }
+    # Determine task state for explicit guidance
+    state = payload.get("state", "")
+    response = payload.get("response", {})
+    success = response.get("success", False) if isinstance(response, dict) else False
+
+    if state == "complete" and success:
+        payload["mcp_task_polling"] = {
+            "task_id": task_id,
+            "state": state,
+            "is_complete": True,
+            "note": "Task is complete. The audio URLs are final and ready to present to the user.",
+        }
+    else:
+        payload["mcp_task_polling"] = {
+            "task_id": task_id,
+            "poll_tool": poll_tool,
+            "batch_poll_tool": batch_poll_tool,
+            "state": state,
+            "is_complete": False,
+            "next_step": f'Task is NOT complete yet (state: "{state}"). '
+            f'IMPORTANT: Only state="complete" with success=true means the task is finished. '
+            f"Ignore any intermediate audio_url values (e.g. audiopipe.suno.ai URLs) — "
+            f"these are streaming previews, NOT final results. "
+            f'Call {poll_tool}(task_id="{task_id}") again after a few seconds.',
+        }
     return payload
 
 

core/utils.py

@@ -65,9 +65,10 @@ def suno_music_generation_guide() -> str:
 ## Important Notes:
 1. Music generation is async in MCP - generation tools should return quickly with a task_id
 2. After any generate/extend/cover/remaster/stems/media conversion call, use `suno_get_task` to poll for the final result
-2. Default model is chirp-v4-5 (good balance of quality and speed)
-3. For longest songs (8 min), use chirp-v5 or chirp-v4-5-plus
-4. Vocal gender only works on v4.5+ models
+3. **CRITICAL POLLING RULE:** You MUST check the `state` field in the response — only `state: "complete"` with `success: true` means the task is done. During the `pending` state, the API may return intermediate `audio_url` values (e.g. audiopipe.suno.ai streaming URLs). These are NOT final results. Do NOT stop polling just because `audio_url` is non-empty — always check `state` first.
+4. Default model is chirp-v5-5 (good balance of quality and speed)
+5. For longest songs (8 min), use chirp-v5 or chirp-v4-5-plus
+6. Vocal gender only works on v4.5+ models
 """
 
 
@@ -80,13 +81,13 @@ def suno_workflow_examples() -> str:
 1. User: "Make me a rock song about freedom"
 2. Call `suno_generate_music(prompt="Rock song about freedom, electric guitars, powerful drums, anthemic")`
 3. Return the task_id from the submission response
-4. Poll with `suno_get_task(task_id)` until the task finishes and audio URLs appear
+4. Poll with `suno_get_task(task_id)` — check the `state` field. Only stop when `state` is `"complete"` and `success` is `true`. Ignore any intermediate `audio_url` during `pending` state.
 
 ## Workflow 2: Custom Song with User's Lyrics
 1. User provides lyrics
 2. Ask for title and style preferences if not provided
 3. Call `suno_generate_custom_music(lyric=user_lyrics, title="...", style="...")`
-4. Poll with `suno_get_task(task_id)` for the completed audio
+4. Poll with `suno_get_task(task_id)` until `state` is `"complete"` (not just until `audio_url` appears)
 
 ## Workflow 3: Creating a Long Song (>4 minutes)
 1. Generate initial song with `suno_generate_music`
@@ -104,7 +105,7 @@ def suno_workflow_examples() -> str:
 1. User has a song_id they want to remix
 2. User describes the new style
 3. Call `suno_cover_music(audio_id, prompt="jazz version", style="smooth jazz, saxophone")`
-4. Poll with `suno_get_task(task_id)` for the completed cover
+4. Poll with `suno_get_task(task_id)` until `state` is `"complete"`
 
 ## Tips:
 - Always be descriptive in prompts - include genre, mood, instruments, tempo

prompts/__init__.py

@@ -32,5 +32,5 @@
       "url": "https://suno.mcp.acedata.cloud/mcp"
     }
   ],
-  "websiteUrl": "https://platform.acedata.cloud"
+  "websiteUrl": "https://suno.mcp.acedata.cloud"
 }

server.json

@@ -29,10 +29,17 @@ async def suno_get_task(
     - You want to get the full details of a generated song
 
     Task states:
-    - 'pending': Generation is still in progress
-    - 'complete': Generation finished successfully
+    - 'pending': Generation is still in progress — KEEP POLLING
+    - 'processing': Generation is being processed — KEEP POLLING
+    - 'complete': Generation finished successfully — this is the ONLY state that means done
     - 'failed': Generation failed (check error message)
 
+    CRITICAL: During the 'pending' state, the response may already contain intermediate
+    audio_url values (e.g. URLs from audiopipe.suno.ai). These are STREAMING PREVIEW URLs,
+    NOT final results. You MUST check the 'state' field — only present the results to the
+    user when state is 'complete' and success is true. Do NOT stop polling just because
+    audio_url is non-empty.
+
     Returns:
         Task status and generated audio information including URLs, title, lyrics, and duration.
     """
@@ -60,6 +67,10 @@ async def suno_get_tasks_batch(
     - You want to get status of several songs at once
     - You're tracking a batch of generations
 
+    CRITICAL: Same as suno_get_task — only consider a task complete when its state
+    is 'complete' and success is true. Intermediate audio_url values during 'pending'
+    state are streaming previews, NOT final results.
+
     Returns:
         Status and audio information for all queried tasks.
     """
@@ -76,16 +87,28 @@ async def suno_get_tasks_batch(
 
     for item in result.get("items", []):
         response_info = item.get("response", {})
+        state = item.get("state", "unknown")
+        success = response_info.get("success", False)
         lines.extend(
             [
                 f"=== Task: {item.get('id', 'N/A')} ===",
+                f"State: {state}",
                 f"Created At: {item.get('created_at', 'N/A')}",
-                f"Success: {response_info.get('success', False)}",
+                f"Success: {success}",
             ]
         )
 
-        for audio in response_info.get("data", []):
-            lines.append(f"  - {audio.get('title', 'Untitled')}: {audio.get('audio_url', 'N/A')}")
+        if state == "complete" and success:
+            for audio in response_info.get("data", []):
+                lines.append(
+                    f"  - {audio.get('title', 'Untitled')}: {audio.get('audio_url', 'N/A')}"
+                )
+        elif state == "failed":
+            lines.append(f"  Error: {response_info.get('error', 'Unknown error')}")
+        else:
+            lines.append(
+                f"  ⏳ Still {state} — keep polling. Any audio_url values are intermediate previews."
+            )
 
         lines.append("")