Documentación / Integraciones / Servidor MCP
Servidor MCP
kedgeway mcp ejecuta un servidor MCP sobre stdio, para que un asistente de IA como Claude Code o Cursor pueda diagnosticar un repo directamente. Expone cinco herramientas.
Herramientas
| Herramienta | Entrada | Devuelve |
|---|---|---|
diagnose | { path | url, ref?, fixture?, failOn?, format? } | Un resumen en texto y el JSON de Diagnosis, o un log SARIF 2.1.0 con format: "sarif". |
findings_reference | ninguna | Los 18 códigos de hallazgo con su severidad, su significado y lo que migrate hace con cada uno. |
migrate | { path | url, ref?, fixture?, write? } | Un resumen que incluye la guía, más el JSON del plan y un diff unificado. Es un dry run salvo que pases write: true. |
ecosystem_snapshot | { fixture? } | El snapshot del ecosistema: en vivo a través de Raven, salvo que indiques un fixture. |
pr | { path, fixture?, base?, branch?, repo?, dry_run?, refresh_lockfiles?, label?, draft? } | Abre o actualiza el pull request de migración. Con dry_run: true devuelve el título y la descripción en su lugar. |
Repositorios remotos
diagnose y migrate aceptan exactamente uno de path o url. url es una URL de git https o ssh, o owner/repo. ref es una rama o un tag y solo aplica con url. El repositorio se clona en modo shallow en un directorio temporal y se elimina al terminar. Consulta Repositorios remotos.
migrate con url siempre es un dry run. write: true devuelve un error, incluso con --allow-write.
Abrir un pull request
La herramienta pr ejecuta el mismo flujo que kedgeway pr: crea la rama kedgeway/migrate-<major> a partir de la base, aplica los cambios a los manifiestos, hace el commit, hace force-push de esa rama y crea o actualiza un único pull request. Necesita un checkout local con un árbol de trabajo limpio: url se rechaza con un error.
La herramienta pr nunca acepta allow_any_branch: una rama fuera de kedgeway/ se rechaza.
Configura tu asistente
Para Claude Code, agrega esto a .mcp.json; para Cursor, a .cursor/mcp.json:
{
"mcpServers": {
"kedgeway": { "command": "kedgeway", "args": ["mcp"] }
}
}Inicio de sesión
diagnose, migrate y ecosystem_snapshot leen del disco local el path o el fixture que les indiques. migrate con write: true edita archivos ahí, pero solo si iniciaste el servidor con kedgeway mcp --allow-write. Sin ese flag, write: true devuelve un error y los dry runs siguen funcionando. La herramienta está anotada como destructiva y no de solo lectura.