Инструкция: 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, когда будет готов.