Tently

Tently MCP: Revisión de pull requests con IA, dentro de tu agente de codificación

Tently es un revisor de código con IA para pull requests de GitHub. Detecta las dos cosas que los revisores que solo ven el diff pasan por alto: regresiones en código que depende del cambio, y cambios que rompen decisiones de diseño que tu equipo tomó a propósito. Aprende esas decisiones de tus pull requests fusionados, hilos de revisión y documentación, y verifica cada pull request contra ellas.

Este repositorio es el servidor MCP de Tently: las mismas decisiones, dentro de Claude Code, Cursor o Codex mientras el agente escribe código, antes de que exista un pull request.

Cómo encajan las piezas

Tently es un almacén de decisiones con dos puertas:

Puerta	Cuándo	Qué hace
Revisión de pull requests (GitHub App)	Cada PR	Publica una ejecución de verificación y comentarios en línea para regresiones y desviaciones de decisiones, con la evidencia adjunta
Este servidor MCP	Mientras el agente escribe	Permite al agente consultar las decisiones que aplican y el radio de impacto de un cambio

El servidor MCP necesita un espacio de trabajo de Tently. Solicita acceso anticipado en tently.dev.

Configuración

Crea una clave de API en la página Connect en app.tently.dev, luego ejecuta esto desde la raíz de tu repositorio:

npx @tently/mcp init --agent claude --api-key <your key>

O pasa la clave a través del entorno:

TENTLY_API_KEY=<your key> npx @tently/mcp init

init agrega el servidor tently a .mcp.json (Claude Code) o .cursor/mcp.json (Cursor), e instala una pequeña habilidad que le dice al agente cuándo usarlo. Hace una copia de seguridad de cualquier archivo antes de editarlo, mantiene tus otros servidores MCP e imprime cada cambio. Reinicia tu agente después.

--agent toma claude, cursor, both o auto (el predeterminado, que detecta lo que hay en el repositorio).

Configuración manual

{
  "mcpServers": {
    "tently": {
      "command": "npx",
      "args": ["-y", "@tently/mcp", "mcp"],
      "env": { "TENTLY_API_KEY": "<your key>" }
    }
  }
}

Lo que obtiene el agente

• search_decisions: las decisiones que aplican al código que está a punto de cambiar, desde tu espacio de trabajo de Tently. Cada una indica si romperla es bloqueante o solo una recomendación.
• query_impact_zone: el radio de impacto de un símbolo (quién lo llama, de qué depende), calculado localmente en tu checkout con CodeGraph. Tu código fuente nunca sale de tu máquina. El índice vive en .codegraph/, que init agrega a .gitignore.

Los resultados de impacto son evidencia, no prueba: los llamadores alcanzados a través de interfaces, despacho dinámico o re-exportaciones pueden pasarse por alto, y la herramienta lo indica en su salida.

Configuración

Variable	Significado
TENTLY_API_KEY	Clave de API del espacio de trabajo (requerida para search_decisions)
TENTLY_API_URL	Origen de la API, predeterminado https://api.tently.dev
TENTLY_WORKING_DIR	Directorio que query_impact_zone indexa, predeterminado el directorio actual

Privacidad

search_decisions envía el texto de tu consulta y las rutas de archivo que pasas a la API de Tently. Nada más sale de tu máquina: query_impact_zone se ejecuta completamente en local. Consulta tently.dev para ver cómo Tently maneja los datos.

Desarrollo

npm install
npm test
npm run build
node dist/cli.js mcp   # start the server on stdio

Requiere Node.js 20 o posterior.

Contribuciones

Las issues y pull requests son bienvenidos. Para cualquier cosa más allá de una corrección pequeña, abre una issue primero para que podamos acordar el enfoque.

Licencia

MIT