Servidor MCP
Conecta asistentes de IA a tus proyectos mediante Model Context Protocol. Explora, lee, busca y edita con las mismas comprobaciones de conflictos que el editor.
Un asistente inicia el servidor MCP de IWE Code con --mcp y usa los flujos estándar. Las herramientas de lectura pueden conectarse a los servidores configurados.
Cómo funciona
- El asistente lanza el binario de IWE Code con el indicador --mcp. El proceso sirve Model Context Protocol por sus flujos estándar.
- El servidor lee el mismo archivo de espacio de trabajo que la aplicación. Los proyectos que añadas o selecciones en IWE Code aparecen de inmediato.
- Las herramientas cubren exploración, lectura, búsqueda y edición. Las herramientas de Git informan de ramas, archivos cambiados y commits recientes.
- Editar exige un token de revisión de la última lectura. La escritura falla si el archivo cambió después de leerlo, así que nada se sobrescribe a ciegas.
Conecta un asistente
Apunta el cliente al binario de la aplicación y añade el indicador --mcp. La ruta del binario depende de tu método de instalación.
Claude Code acepta un comando:
claude mcp add iwe -- /path/to/iwe --mcp
Claude Desktop, Cursor y otros clientes leen una configuración mcpServers:
{
"mcpServers": {
"iwe": {
"command": "/path/to/iwe",
"args": ["--mcp"]
}
}
}Herramientas
El servidor MCP ofrece once herramientas. Solo write_file cambia archivos de texto locales existentes. La solicitud tools/list devuelve los esquemas de entrada.
list_projects- Lista espacios y proyectos, con el proyecto seleccionado marcado.
list_files- Lista archivos y carpetas de un nivel de un proyecto.
read_file- Lee un archivo de texto. La respuesta incluye un token de revisión para editar.
write_file- Sustituye el contenido de un archivo de texto existente usando su token de revisión.
search_files- Encuentra archivos por búsqueda difusa de nombre y ruta.
git_status- Muestra la rama actual y los archivos cambiados.
git_log- Muestra commits recientes con autores, fechas y referencias.
list_deployments- Enumera conexiones, claves SSH registradas y perfiles. El resultado omite los secretos.
resolve_deployment_path- Indica profile y una ruta: local o remote. Devuelve la asignación sin conectarse.
deployment_read_remote- Indica profile y un path remoto absoluto. Lee un archivo UTF-8 de hasta 512 KiB.
deployment_compare- Indica profile y un path relativo al proyecto. Devuelve localText, remoteText e identical. Cada archivo admite hasta 512 KiB.
El flujo de edición
- Lee el archivo. La respuesta incluye el contenido y un token de revisión.
- Envía el contenido cambiado de vuelta con el mismo token.
- El servidor comprueba el archivo contra el token antes de escribir. Rechaza la escritura si el archivo cambió tras tu lectura.
- Vuelve a leer el archivo y repite cuando se rechace una escritura.
Seguridad
- Las herramientas usan los proyectos del espacio de trabajo. Las rutas locales deben permanecer dentro del proyecto.
- MCP usa credenciales guardadas para leer archivos remotos. Los resultados omiten las credenciales.
- Los metadatos del espacio y los archivos remotos permanecen intactos. Usa la CLI para gestionar despliegues y transferir archivos.
- El servidor rechaza líneas JSON-RPC entrantes de más de 1 MiB. Cada texto de una lectura remota tiene un límite de 512 KiB.
Compila desde el código fuente
Usa el binario instalado de la aplicación o compila desde el fuente:
cargo build --release # The binary lands in target/release/iwe
Documentación para desarrolladores
La documentación para desarrolladores describe el protocolo, las herramientas y sus límites en detalle.