mcp-content-ops

Un servidor MCP que permite a un agente trabajar con contenido CMS. Las herramientas son la parte aburrida — buscar, leer, crear un borrador, establecer un campo, publicar. Lo que requirió reflexión es lo que ocurre antes de que cualquiera de ellas se ejecute.

La mayoría de los servidores MCP de contenido que hemos examinado le entregan al modelo un cliente de API y una credencial con los permisos que la cuenta de integración tenga, que en un CMS suele ser todo. La demo funciona. Luego alguien le pide al agente que «ordene las páginas de producto» y publica cuarenta borradores, porque nada en el sistema ha dicho nunca que no pudiera hacerlo.

El alcance

Cuatro compuertas, en orden, y ninguna de ellas reside en el esquema de la herramienta:

1. Validación de argumentos contra el esquema publicado. Las propiedades desconocidas se rechazan en lugar de descartarse: un modelo que inventa un argumento ha malinterpretado la herramienta, y descartarlo silenciosamente oculta ese error.

2. Denegación por defecto. Las operaciones de escritura están desactivadas a menos que la configuración las active. No hay ningún valor predeterminado permisivo en Policy.

3. Listas de permitidos de tipos y campos. Que un tipo sea legible no lo hace escribible, y que un tipo sea escribible no hace que todos sus campos lo sean.

4. Auditoría estructurada de cada llamada, permitida o rechazada, con el motivo.

El tipo contra el que se evalúa una llamada proviene del elemento almacenado, nunca de los argumentos. Permitir que quien llama afirme qué tipo de cosa está editando es permitir que elija qué política se aplica.

Una llamada rechazada vuelve como un resultado de herramienta normal con isError establecido, no como un error JSON-RPC. El modelo debería ver por qué fue rechazada y adaptarse; un error de protocolo significa que el cliente está roto, lo cual es una conversación distinta.

Related MCP server: ToolBridge

Ejecutarlo

pip install -e ".[dev]"
python -m content_ops.server policy.example.json
pytest -q

El CMS que hay detrás es un stub en memoria en cms.py — cuatro métodos, cámbialo por tu API de contenido.

Lo que no hace

No hay herramienta de borrado, a propósito. Sin recursos ni prompts, solo herramientas. Sin autenticación: es un servidor stdio y el límite de confianza es el proceso que lo lanzó. El validador de esquemas cubre el subconjunto que utilizan nuestros propios esquemas de herramienta, no todo JSON Schema.

Por qué no usar un SDK

El MCP Python SDK es bueno y para un servidor más grande es la elección correcta. Este implementa tres métodos sobre stdio, y el formato de transmisión es lo bastante pequeño como para que una dependencia que se mueve al ritmo al que se mueven actualmente los SDK fuera el mayor riesgo.