QuillBot Local MCP

Servidor MCP por STDIO, no oficial y experimental, para automatizar la interfaz web de QuillBot mediante Playwright. Devuelve texto del servicio y no modifica documentos.

Estado: protocolo MCP probado; integración con el sitio real pendiente de validación. Los selectores de la interfaz están vacíos intencionalmente. Después de instalar, quillbot_status funciona; detector y humanizador permanecerán bloqueados hasta configurar y comprobar sus controles reales. No es una integración lista para usar sin configuración. Los análisis hechos por separado desde un navegador no validan este adaptador.

Requisitos e instalación

Node.js 22 o posterior y un cliente compatible con MCP por STDIO. La cuenta, suscripción y límites aplicables dependen de QuillBot.

git clone https://github.com/Disneik/quillbot-local-mcp.git
cd quillbot-local-mcp
npm ci
npx playwright install chromium
npm test

En Linux puede ser necesario npx playwright install --with-deps chromium. Consulte la instalación oficial de Playwright.

Copie settings.example.json como settings.json:

# Linux / macOS
cp settings.example.json settings.json

# PowerShell
Copy-Item settings.example.json settings.json

Related MCP server: jev-browser

Conectar un cliente MCP

Copie la entrada de mcp.example.json a la configuración MCP de su cliente. Sustituya ambas rutas absolutas por las de su copia local. En Windows se pueden utilizar barras /. node debe estar en el PATH del cliente; si no, indique su ruta absoluta. Los formatos de configuración pueden variar entre clientes.

La variable QUILLBOT_SETTINGS selecciona el archivo local. Si se omite, el servidor usa el ejemplo seguro incluido, con navegador deshabilitado. Para iniciar manualmente, use npm start (STDIO queda reservado para MCP).

Configurar y validar QuillBot

1. Autorice el uso del navegador en su cliente o entorno. Este servidor abre su propio Chromium mediante Playwright y no hereda las restricciones técnicas del navegador del cliente.

2. En settings.json, active browserAccessEnabled únicamente si tiene esa autorización. Mantenga verifiedAgainstLiveSite: false.

3. Llame a quillbot_inspect con {"mode":"detector","visible":true}. Complete personalmente el inicio de sesión en la ventana si se solicita. Se usa un perfil propio; no se importan sesiones ni cookies de otros navegadores.

4. A partir de controles observados en la página, complete editorSelector (CSS), submitButtonName (nombre accesible exacto del botón) y resultSelector (CSS del resultado). flaggedSelector es opcional para pasajes señalados. Repita para humanizer. Las URLs iniciales pueden requerir ajustes si el servicio cambia.

5. Para efectuar una comprobación manual, habilite verifiedAgainstLiveSite y pruebe con un fragmento autorizado sin información sensible. Compare la entrada y salida con la página. Si la comprobación falla, vuelva a false y corrija la configuración antes de usarlo con otros textos.

Los selectores y el resultado dependen de la interfaz actual, del idioma y de la sesión. Un cambio en el DOM puede requerir una nueva validación. El servidor espera que el contenedor tenga texto diferente al anterior al envío; ese criterio no garantiza por sí solo que una respuesta parcial haya terminado ni que un resultado esté asociado a la entrada correcta. Compruébelo durante la validación. Si el servicio devuelve exactamente el mismo texto que antes, puede agotarse el tiempo de espera.

Para iniciar sesión de forma visible, haga la inspección visible antes de otra operación de navegador. Si ya existe un contexto oculto, reinicie el servidor primero. Las pestañas de inspección visible quedan abiertas para que el usuario pueda completar el acceso.

Herramientas

Las respuestas contienen JSON breve, fecha, huella SHA-256 de la entrada y texto literal del servicio. No se infieren porcentajes adicionales. Solo se admite una operación simultánea. El límite local es de 30 000 caracteres por llamada; el límite real del servicio puede ser menor.

Datos y límites

Las herramientas de detección y humanización envían el texto a QuillBot. El servidor no guarda los textos como informes, pero el cliente MCP y QuillBot pueden aplicar sus propias políticas de almacenamiento. El perfil .browser-profile/ conserva la sesión: no lo comparta. settings.json, perfiles, informes y archivos de entorno quedan excluidos de Git.

No se incluyen claves, credenciales, cookies, textos de investigación ni documentos personales. No se automatizan CAPTCHA ni compras. Si hay un desafío, bloqueo, suscripción insuficiente o inicio de sesión pendiente, debe atenderlo el usuario. Los resultados del detector no certifican autoría y la paráfrasis necesita revisión del sentido, los datos y las citas; no se garantiza un resultado en Turnitin u otros servicios.

Pruebas y contribuciones

npm test comprueba el protocolo STDIO, controles de acceso, destinos permitidos, resultados vacíos y exclusión mutua. Usa datos simulados identificados como tales; no inicia Chromium ni constituye una prueba contra QuillBot. Las contribuciones que configuren selectores deben documentar fecha, idioma y pasos de validación, sin aportar sesiones ni textos privados.

Implementado con el SDK oficial de MCP y Playwright. Proyecto independiente, sin afiliación con QuillBot.

Licencia

MIT. Consulte LICENSE.