QuickerSpot MCP Server

mcp-name: io.github.raphaelInacio/quickerspot-mcp

QuickerSpot MCP サーバー

QuickerSpot プラットフォームの公式 Model Context Protocol（MCP） サーバーです。AI を活用したジングルの自動作成、店内ラジオ、商業施設向け音響を実現します。

AI アシスタント（Cursor IDE、Claude Desktop、Antigravity、Hermes Agent、OpenClaw）を、ElevenLabs V3 の音声エンジン、AI スクリプト生成機能、QuickerSpot の店内ラジオミキサーに直接接続します。

---

🚀 2 ステップで使い始める

1. API Key を取得する

QuickerSpot のダッシュボード quickerspot.com/settings にアクセスし、新しい API Key（例：qs_live_...）を作成します。

2. mcp.json を設定する

mcp.json（または claude_desktop_config.json）にサーバーの定義を追加します。

{
  "mcpServers": {
    "quickerspot": {
      "command": "uvx",
      "args": ["quickerspot-mcp"],
      "env": {
        "QUICKERSPOT_API_KEY": "qs_live_SUA_CHAVE_AQUI"
      }
    }
  }
}

quickerspot-mcp は QuickerSpot の本番バックエンドに自動的に接続します。ローカルで開発している場合は、env ブロックに "QUICKERSPOT_API_URL": "http://localhost:8000" を追加できます。

---

🛠️ 利用可能な MCP ツール（tools）

1. list_voices() — 利用可能な商業用音声のカタログ（Camila、Helena、Marcos、Carlos、Ricardo）を返します。
2. create_campaign(name, data, voice_tone, free_text) — 新しい商業キャンペーンを作成し、AI によるスクリプトを同期的に生成します。
3. approve_script(campaign_id, script, background_music) — スクリプトを承認し、スタジオ品質の音声合成を開始します。
4. remix_campaign_audio(campaign_id, background_music, audio_style) — 音声合成（TTS）の追加費用なしで、BGM とマスタリングを適用または差し替えます。
5. get_campaign_status(campaign_id) — ステータス（PENDING、PROCESSING、COMPLETED）、スクリプト、MP3 のダウンロード URL を確認します。
6. list_campaigns() — アカウントのすべてのアクティブなキャンペーンを一覧表示します。
7. create_recado(text, voice_id) — 店舗向けのジングル付きお知らせ音声を即座に生成します（HITL フローなしの高速処理）。

---

💻 ローカルで Python を実行する（任意）

Python でローカル実行する場合：

{
  "mcpServers": {
    "quickerspot": {
      "command": "python",
      "args": ["-m", "quickerspot_mcp.server"],
      "env": {
        "QUICKERSPOT_API_KEY": "qs_live_SUA_CHAVE_AQUI"
      }
    }
  }
}