convez.ai
MCP ServerIntegração & APIsIntermediário
runnel

Voog MCP — Gerenciador CMS Voog

runnel/voog-mcp

Controle Voog CMS pelo terminal ou Claude com templates, páginas e produtos

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP e CLI para gerenciar o Voog CMS (website builder multilíngue com ecommerce integrado) diretamente do terminal ou através de clientes MCP como Claude. Permite editar templates Liquid, páginas, produtos, redirecionamentos e configurações de ecommerce via API administrativa.

Instalação

$npx convez-ai runnel/voog-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
0
Acompanhando
1
Saúde
57%
Último commit
há 3 meses
Versão
v1.5.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar edição de templates Liquid em sites Voog via CLI
  • Integrar gerenciamento de produtos e redirecionamentos em workflows MCP/Claude
  • Sincronizar conteúdo e configurações ecommerce entre ambientes

Veredito

Ferramenta sólida para quem trabalha com Voog: oferece cobertura completa da API do CMS em Python com suporte MCP nativo. Qualidade de código é boa (testes, CI, versionamento semântico), mas o alcance fica limitado ao ecossistema Voog — relevante se você já usa essa plataforma.

README

A tradução para o português deste README ainda está na fila.

voog-mcp

PyPI tests license: MIT python: 3.10 | 3.11 | 3.12

CLI and MCP server for Voog CMS — manage Liquid templates, pages, products, ecommerce settings, and redirects from your terminal or directly from Claude / any MCP client.

What is Voog?

Voog is a multilingual website builder and CMS with built-in ecommerce, used for content sites and small online stores. This package wraps its admin API so you can edit templates, pages, products, and redirects from your shell or an LLM agent.

Install

From PyPI:

pip install voog-mcp
# or, no install: uvx voog-mcp --help

Or directly from GitHub (latest unreleased main):

uvx --from git+https://github.com/runnel/voog-mcp.git voog --help

For development:

git clone https://github.com/runnel/voog-mcp
cd voog-mcp
python3.10 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

Configure

Run voog config init to interactively create the global config:

voog config init

This creates ~/.config/voog/voog.json with your tokens inline:

{
  "sites": {
    "mysite":   {"host": "mysite.com",   "api_key": "vk_..."},
    "client_a": {"host": "clienta.com",  "api_key": "vk_..."}
  },
  "default_site": "mysite"
}

Get a token from your Voog admin: Admin → API.

Shared / CI configs

If voog.json is checked into version control or shared across machines, keep the token out of the file by referencing an env var instead:

{
  "sites": {
    "client_a": {"host": "clienta.com", "api_key_env": "CLIENT_A_KEY"}
  }
}

Then put the token in ~/.config/voog/.env:

CLIENT_A_KEY=vk_...

Both forms can coexist per-site. When both api_key and api_key_env are set, the env-var wins if it's defined — so an inline value acts as a default that the deployment overrides.

Per-repo site selection

In a repo dedicated to one Voog site, drop a voog.json at the repo root to pin the site:

{"default_site": "mysite"}

The cwd-level voog.json deep-merges over the home config, with cwd winning per-key. Inside sites, the merge is per-site name — a cwd entry replaces the whole site definition (host + token), it does not merge individual fields. You can also redefine entire sites here (handy for client repos that should bring their own host/token without touching the home config):

{
  "sites": {
    "client_x": {"host": "clientx.com", "api_key": "vk_..."}
  },
  "default_site": "client_x"
}

Now voog pull / voog push from that directory always target the right site, even if the home default differs.

Note: voog-site.json from earlier versions still works but emits a DeprecationWarning. Replace it with voog.json containing {"default_site": "<name>"} for the same effect.

Use the CLI

voog --help                      # all commands
voog config list-sites           # show configured sites
voog --site mysite products      # list products on mysite
voog pull                        # download templates (uses cwd-level voog.json)
voog push layouts/Front\ page.tpl
voog redirects
voog config check                # verify all configured tokens
voog site-snapshot backup/       # full-site snapshot for diff/audit

Use as MCP server

Add to your Claude Code config (or any MCP client). The simplest setup uses the published PyPI package:

{
  "mcpServers": {
    "voog": {
      "command": "uvx",
      "args": ["voog-mcp"]
    }
  }
}

If you'd rather track unreleased main (e.g. for a fix that hasn't shipped yet), point uvx at the GitHub repo instead:

{
  "mcpServers": {
    "voog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/runnel/voog-mcp.git", "voog-mcp"]
    }
  }
}

Every tool requires a site parameter. Start with voog_list_sites to discover what's configured:

voog_list_sites()
→ [{"name": "mysite", "host": "mysite.com"}, ...]

page_get(site="mysite", page_id=42)
→ {...}

Tools

Full endpoint coverage reference: docs/voog-mcp-endpoint-coverage.md

GroupTools
Sitesvoog_list_sites, voog_list_my_sites
Searchvoog_search
Pagespages_list, page_get, page_create, page_update, page_set_hidden, page_set_layout, page_set_data, page_delete_data, page_duplicate, page_delete
Articlesarticles_list, article_get, article_create, article_update, article_publish, article_set_data, article_delete_data, article_delete
Commentscomments_list, comment_delete, comment_toggle_spam
Tagstags_list, tag_get, tag_delete
Layoutslayouts_pull, layouts_push, layout_create, layout_update, layout_rename, layout_delete, layout_asset_create, layout_asset_update, layout_asset_delete, asset_replace
Texts / contentstext_get, text_update, page_add_content, content_partial_update
Elementselements_list, element_get, element_definitions_list, element_create, element_update, element_move, element_delete
Productsproducts_list, product_get, product_create, product_update, product_set_images, product_delete, product_duplicate, products_bulk_action
Categoriescategories_list, category_get, category_create, category_update, category_delete
Ordersorders_list, order_get (read-only; PII-stripped by default, include_pii=true requires force=true)
Discountsdiscounts_list, discount_get, discount_create, discount_update, discount_delete
Cart rulescart_rules_list, cart_rule_get, cart_rule_create, cart_rule_update, cart_rule_delete
Shipping / paymentsshipping_methods_list, gateways_list
Ecommerce settingsecommerce_settings_get, ecommerce_settings_update
Multilinguallanguages_list, language_create, language_delete, nodes_list, node_get, node_update, node_move, node_relocate
Redirectsredirects_list, redirect_add, redirect_update, redirect_delete
Sitesite_get, site_update, site_set_data, site_delete_data
Webhookswebhooks_list, webhook_create, webhook_update, webhook_delete
Snapshotpages_snapshot, site_snapshot
Read-only passthroughvoog_admin_api_read, voog_ecommerce_api_read
Generic passthroughvoog_admin_api_call, voog_ecommerce_api_call (GET deprecated — use the _read tools above)

What's NOT supported

voog-mcp covers content + ecommerce catalog management end-to-end as of v1.4. The following Voog API areas remain out of scope — drop down to the voog_admin_api_call / voog_ecommerce_api_call passthrough tools when you need them:

  • Order mutation — orders_list / order_get are read-only typed tools (with PII stripping); creating / updating / cancelling orders goes via passthrough. Order writes carry finance / operations risk that a future release will design separately.
  • Cart reads — cart_rules_* tools cover cart-rule CRUD, but reading individual cart sessions (/carts) is passthrough-only.
  • element_definitions CRUD — element_definitions_list is wrapped; create / update / delete remain passthrough.
  • People / site_user admin — full passthrough.
  • Form definitions and form responses — passthrough.
  • Site favicons and bulk file imports — product image galleries are first-class via product_set_images; other multipart uploads go via passthrough.
  • Site creation — voog-mcp targets existing sites.

If you need any of these, open an issue — or a PR.

License

MIT

Ver o original no GitHub

Bom para

Relacionados