Инструкция: Trekopes / Tpekollec MCP

Инструкция: Trekopes / Tpekollec MCP

Hermes Agent

Инструкция: как пользоваться Trekopes / Tpekollec MCP

1. Endpoint

Trekopes / Tpekollec MCP endpoint:

https://bot.tpekollec.ru/api/mcp

2. Подключение в Hermes

Добавьте MCP-сервер в config.yaml:

mcp_servers:
  tpekollec:
    url: "https://bot.tpekollec.ru/api/mcp"
    headers:
      Authorization: "Bearer ВАШ_TOKEN"
    timeout: 180
    connect_timeout: 60

После изменения конфига выполните:

/reload-mcp

или перезапустите Hermes / gateway.

3. Ожидаемые MCP tools

После подключения должны появиться инструменты примерно такого вида:

mcp_tpekollec_generate_content
mcp_tpekollec_get_generation_status
mcp_tpekollec_list_generations
mcp_tpekollec_get_balance
mcp_tpekollec_generate_lyrics
mcp_tpekollec_get_lyrics_status
mcp_tpekollec_list_templates
mcp_tpekollec_list_artists

Точное имя зависит от имени сервера в `mcp_servers`.

4. Генерация песни / MP3

Для песни используйте `generate_content` с `type: "text"`.

Пример аргументов:

{
  "type": "text",
  "title": "Название песни",
  "prompt": "Сгенерируй полноценный MP3-трек на русском языке по заданным lyrics.",
  "lyrics": "[Intro]\n...\n[Verse 1]\n...\n[Chorus]\n...",
  "skip_lyrics_generation": true,
  "style": "sci-fi synth-rock anthem, heroic but ironic, orchestral brass, marching drums, male choir, Russian vocals",
  "mood": "heroic, ironic, triumphant",
  "tempo": 128,
  "voice": "male"
}

5. Структура lyrics

Рекомендуемая структура:

[Intro]

[Verse 1]
...

[Pre-Chorus]
...

[Chorus]
...

[Bridge]
...

[Final Chorus]
...

[Outro]
...
```

Если lyrics уже готовы, ставьте:

"skip_lyrics_generation": true

6. Проверка статуса

После запуска сохраните `generation_id`, `song_id`, `id` или UUID из ответа.

Потом вызывайте:

get_generation_status

Готовность MP3 подтверждается только если в ответе есть `download_url`, `audio_url`, `tracks`, `song_id` или другой аудио-маркер.

7. Прямой HTTP JSON-RPC fallback

Если нативные MCP tools не появились, но есть endpoint/token, можно вызвать сервер напрямую.

Проверка:

curl -sS -X POST "https://bot.tpekollec.ru/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer ВАШ_TOKEN" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {"name": "hermes-direct", "version": "0.1"}
    }
  }'

Запуск tool call:

curl -sS -X POST "https://bot.tpekollec.ru/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer ВАШ_TOKEN" \
  --data '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "generate_content",
      "arguments": {
        "type": "text",
        "title": "Agent Garden Anthem",
        "prompt": "Сгенерируй полноценный MP3-трек на русском языке по заданным lyrics.",
        "lyrics": "[Intro]\n...\n[Verse 1]\n...\n[Chorus]\n...",
        "skip_lyrics_generation": true,
        "style": "sci-fi synth-rock anthem, heroic but ironic, Russian vocals",
        "mood": "heroic, ironic, triumphant",
        "tempo": 128,
        "voice": "male"
      }
    }
  }'

8. Pitfalls

- Для песни используйте `type: "text"`, не `scenario`.
- Не путайте MCP с Telegram-ботом Trekopes.
- Не говорите, что MP3 готов, пока нет audio URL / tracks / song_id.
- При batch-генерации делайте паузу 5–6 секунд между запросами.
- Не печатайте токен в чат и логи.
- `401 Unauthorized` значит токен неверный или устарел.

9. Быстрый режим

Команда:

фас фас

означает:

Немедленно сгенерируй MP3 через Trekopes/Tpekollec MCP с разумными defaults. Не используй Telegram-бота. Не проверяй баланс. Не выводи lyrics. Запусти генерацию и потом принеси MP3, когда будет готов.

Report Page