ealmeida
82c800bfe0
Documenta as 14 tools do MCP dedicado (mcp-seriously-simple-podcasting, porta 3203) para episódios/shows/definições de show em emanuelalmeida.pt, complementado pela skill de conhecimento seriously-simple-podcasting (achado central: REST nativo do plugin é escrita-capaz para episódios mas read-only para definições de show).
82 lines
5.2 KiB
Markdown
82 lines
5.2 KiB
Markdown
---
|
|
name: mcp-seriously-simple-podcasting
|
|
description: MCP dedicado (HTTP StreamableHTTP local, ligação `seriously-simple-podcasting` em ~/.claude.json, porta 3203) para o Seriously Simple Podcasting em emanuelalmeida.pt (produção, 39 episódios reais em 8 shows) — episódios (CPT `podcast`), shows/séries (taxonomia `series`) e definições de show (título, owner, categorias iTunes, explicit/complete). Escritas sempre via bootstrap WordPress (`wp_insert_post`/`wp_update_post`/`wp_insert_term`/`update_option`), nunca SQL directo. Usar quando "episódio podcast", "criar episódio", "show podcast", "definições de show", "categoria itunes", "feed rss emanuelalmeida", "apagar episódio", "estatísticas podcast", ou qualquer gestão de conteúdo de podcast em emanuelalmeida.pt.
|
|
layer: wiki
|
|
---
|
|
|
|
# /mcp-seriously-simple-podcasting — MCP dedicado Seriously Simple Podcasting (emanuelalmeida.pt)
|
|
|
|
Projecto em `/media/ealmeida/Dados/Dev/mcp-seriously-simple-podcasting/` (TypeScript, SDK MCP
|
|
oficial, StreamableHTTP). O REST API nativo do plugin é escrita-capaz para episódios mas
|
|
**read-only para definições de show** (`wp/v2/series` só regista `get_callback`, achado
|
|
confirmado lendo `Rest_Api_Controller::create_api_series_fields()`) — por isso este MCP usa um
|
|
único mecanismo consistente para tudo (episódios e shows): o bootstrap WordPress completo via
|
|
`wp eval`, nunca REST nem SQL directo para escritas.
|
|
|
|
**Zona-alvo: emanuelalmeida.pt (produção), 39 episódios reais em 8 shows.**
|
|
|
|
## Arquitectura — sem tocar no filesystem do servidor
|
|
|
|
Leituras: SQL directo via `$wpdb` (rápido, tipado). Escritas: SEMPRE pelas funções nativas do
|
|
WordPress (`wp_insert_post`/`wp_update_post`/`wp_delete_post`, `wp_insert_term`/`wp_delete_term`,
|
|
`wp_set_post_terms`, `update_post_meta`, `update_option`) — nunca INSERT/UPDATE directo, para
|
|
preservar hooks de feed/permalinks/sanitização nativa. Ambas correm por SSH via `wp eval`, com o
|
|
corpo PHP + dados de entrada codificados em base64 dentro de uma variável de ambiente remota —
|
|
**nunca ficheiros escritos/apagados no servidor**, o que evitaria deliberadamente o GATE 5.1 de
|
|
mutação de infra-estrutura. Ver `src/wp-bridge.ts` (`runPhp()`) — mesmo mecanismo do
|
|
`mcp-fluent-crm`.
|
|
|
|
## Tools (14)
|
|
|
|
**Leitura (7):** `ssp_list_episodes` (filtros série/estado/pesquisa), `ssp_get_episode`,
|
|
`ssp_list_series`, `ssp_get_series_settings` (corrige o bug do REST nativo para
|
|
explicit/complete), `ssp_get_stats`, `ssp_get_feed_url`, `ssp_get_itunes_categories` (referência
|
|
estática, sem chamada SSH).
|
|
|
|
**Escrita (7):** `ssp_create_episode`, `ssp_update_episode`, `ssp_delete_episode` (trash por
|
|
omissão, `force=true` apaga permanentemente), `ssp_set_episode_series`, `ssp_create_series`,
|
|
`ssp_update_series_settings`, `ssp_delete_series` (destructive — ver guarda abaixo).
|
|
|
|
## Guardas de segurança
|
|
|
|
- `ssp_update_series_settings`/`ssp_create_series` validam `category`/`category2`/`category3` e
|
|
`subcategory`/`subcategory2`/`subcategory3` contra a lista oficial Apple Podcasts **antes** de
|
|
qualquer chamada SSH (rejeita categoria inexistente ou par categoria/subcategoria incoerente com
|
|
erro accionável).
|
|
- `ssp_delete_series` recusa remover um show com episódios associados sem `force=true` — **mas
|
|
atenção:** a contagem usada (`term->count`) só reflecte episódios **publicados**; um show só com
|
|
episódios em `draft` passa como "vazio" mesmo tendo conteúdo associado. Confirmar sempre com
|
|
`ssp_list_episodes({series_id, status: 'any'})` antes de forçar a remoção.
|
|
- `ssp_delete_episode` por omissão move para o lixo (recuperável); `force=true` apaga
|
|
permanentemente.
|
|
|
|
## Fora do v1 (decisão deliberada)
|
|
|
|
Gestão da ligação Castos/hosting (não aplicável — desligada neste site), upload directo de
|
|
ficheiros de áudio (o plugin só aceita URL, sem endpoint de upload próprio — usar Media Library
|
|
via ferramentas WordPress genéricas e passar o URL resultante), CRUD de tags normais (`post_tag`)
|
|
— usar ferramentas WordPress genéricas para isso, o CPT `podcast` é standard.
|
|
|
|
## Credenciais
|
|
|
|
`.env` local (`WP_SSH_HOST=server`, `WP_PATH=/home/ealmeida/emanuelalmeida.pt`), não versionado.
|
|
Sem tokens/API keys — a autenticação é a própria sessão SSH root já configurada em
|
|
`~/.ssh/config`.
|
|
|
|
## Verificação
|
|
|
|
Construído e testado ponta-a-ponta contra a zona real 19-08-2026: todas as 14 tools exercitadas
|
|
manualmente (incl. guarda de categoria inválida e guarda de show com episódio publicado) + 13/13
|
|
evaluations automatizadas (`npm run eval:ci`), que criam e limpam os seus próprios artefactos
|
|
(`__mcp_eval__`) sem tocar em dados reais. Deploy como processo `hub` persistente
|
|
(`mcp-seriously-simple-podcasting`, porta 3203, `http://127.0.0.1:3203/mcp`), registado em
|
|
`~/.claude.json` como `seriously-simple-podcasting`.
|
|
|
|
## Skills relacionadas
|
|
|
|
- `seriously-simple-podcasting` — conhecimento profundo do plugin: arquitectura CPT/taxonomia,
|
|
achado central do REST nativo (episódios escrita-capaz, shows read-only), schema de
|
|
`wp_options` das definições de show (com o gotcha explicit/complete), categorias iTunes, feed
|
|
RSS, wp-admin — consultar antes de desenhar uma integração ou entender um comportamento que este
|
|
MCP não cobre.
|