sap-adt-mcp

Servidor MCP y cliente Python para la API REST de SAP ADT (ABAP Development Tools). Da a tu asistente de IA las mismas operaciones que usa Eclipse ADT — buscar en el repositorio, leer y escribir código fuente, activar, verificar sintaxis y trabajar con solicitudes de transporte — hablando con los mismos endpoints /sap/bc/adt/*.

Documentación técnica completa también en inglés: docs/PROJECT_DOCUMENTATION.md.

Lo que se puede hacer

• Buscar y navegar — objetos por comodín (Z*, ZCL_*), contenido de paquetes (incluido con namespace /ACME/PKG) y metadatos

• Leer y escribir fuente — con bloqueo, asignación de transporte y activación en una sola llamada; opcionalmente guardando/leyendo archivos locales

• Activar y verificar sintaxis — con mensajes de error por línea y columna

• Transportes — listar, crear, liberar y comprobar si un objeto necesita uno

• Crear objetos — programas, clases, interfaces y paquetes (locales o transportables)

• Exportar DDIC en Markdown — tablas, elementos de datos, dominios y vistas se convierten en contexto legible para la IA

• Funcionar en releases antiguos — los media types se negocian por endpoint y sap_system_info indica qué soporta ese sistema

Las credenciales quedan en el administrador de credenciales del sistema operativo; ninguna contraseña se guarda en archivos del proyecto.

Related MCP server: mcp-abap-abap-adt-api

Requisitos

Los requisitos previos del lado SAP (servicios ICF, roles y objetos de autorización) se detallan en la sección 6 de la referencia de comandos.

Instalación

Directamente desde GitHub (recomendada)

pip install git+https://github.com/engoetz/sap-adt-mcp

Esto registra dos comandos en el PATH:

Sin instalar nada permanentemente, con uv:

uvx --from git+https://github.com/engoetz/sap-adt-mcp sap-adt-mcp

Desde el código fuente (para desarrollar)

git clone https://github.com/engoetz/sap-adt-mcp
cd sap-adt-mcp
python -m venv .venv && .venv/Scripts/activate   # Linux/macOS: source .venv/bin/activate
pip install -e ".[dev]"
python -m pytest tests -q

Configurar en el cliente MCP

Después de la instalación, el comando sap-adt-mcp ya está en el PATH — no hace falta ruta absoluta:

{
  "mcpServers": {
    "sap-adt": {
      "command": "sap-adt-mcp",
      "args": []
    }
  }
}

Dónde colocar este bloque:

Si prefieres ejecutarlo directamente desde el código fuente, sin instalar el paquete, cámbialo por "command": "python", "args": ["/caminho/para/sap-adt-mcp/scripts/run_mcp.py"].

Verificar

En Cursor, el servidor aparece como user-sap-adt en Settings > MCP. Para probar en cualquier cliente, pide sap_list_environments() — debe devolver la lista de conexiones guardadas.

Credenciales

Desde el terminal (recomendado)

sap-adt add DEV

El comando pregunta host, puerto, mandante, usuario, idioma y HTTPS (Enter acepta el valor sugerido) y, por último, la contraseña — escrita dos veces, sin eco en pantalla. Así no entra en el historial del shell ni en el historial de la conversación con la IA.

sap-adt list                      # conexões salvas e se têm senha
sap-adt edit DEV --port 8020      # alterar campos sem tocar na senha
sap-adt password DEV              # trocar apenas a senha
sap-adt test DEV                  # conectar e sondar os endpoints ADT
sap-adt delete DEV                # remover conexão e senha

No existe el parámetro --password: por definición, la contraseña solo se introduce por prompt. Para automatización, se acepta la variable SAP_PASSWORD.

La contraseña va al keyring del SO (Windows Credential Manager, macOS Keychain, Linux Secret Service). Los demás parámetros quedan en ~/.sap-adt/environments.json, fuera del proyecto.

Desde el chat

sap_save_password(system_id="DEV", host="...", port=8000, client="100", user="username", password="...") hace lo mismo — pero la contraseña queda registrada en la conversación. Prefiere el terminal.

Primer uso

sap_connect(system_id="DEV")
sap_system_info()                       # o que este sistema suporta (rode em release antiga)

sap_search(query="Z*", object_type="CLAS")
sap_read_source(object_name="ZCL_MINHA_CLASSE", object_type="CLAS")

sap_write_source(
    object_name="ZCL_MINHA_CLASSE",
    object_type="CLAS",
    source_code="...",
    transport_request="DEVK900123"
)

Fuera del cliente MCP, sap-adt test DEV hace el mismo diagnóstico desde el terminal.

Compatibilidad entre releases

Los sistemas más antiguos (ECC, NetWeaver 7.3x) exponen un subconjunto del ADT y no siempre entienden las mismas versiones de media type. El cliente lo gestiona solo:

• Media types negociados por endpoint, del más nuevo al más antiguo, memorizando lo que funcionó

• Discovery con alternativas cuando /sap/bc/adt/discovery no está activo en SICF

• Transporte enviado de las dos formas (corrNr en la query y header sap-transportrequest)

• sap_system_info sondea los endpoints e indica qué herramientas no funcionarán allí

Detalles en la sección 6.7 de la referencia.

Herramientas MCP (25)

Conexión y credenciales

Repositorio

Código fuente

Transportes

Creación y eliminación

Parámetros, ejemplos y retornos de cada una: docs/MCP_COMMAND_REFERENCE.md

Arquitectura

Cliente MCP  →  servidor MCP (stdio/JSON-RPC)  →  cliente REST ADT  →  SAP /sap/bc/adt/*

src/sap_adt/
├── client.py            # HTTP: autenticação, CSRF, sessões stateful, negociação de media type
├── credential_store.py  # ~/.sap-adt/environments.json + keyring do SO
├── repository.py        # pesquisa, navegação de pacotes, metadados
├── source.py            # leitura/escrita de fonte com bloqueio
├── activation.py        # ativação e verificação de sintaxe
├── transport.py         # transport requests (CTS)
├── ddic_export.py       # DDIC → Markdown
├── cli.py               # comando `sap-adt`
├── models.py            # dataclasses
├── exceptions.py        # hierarquia de exceções
└── mcp_server.py        # servidor MCP com as 25 ferramentas

Desarrollo

pip install -e ".[dev]"
python -m pytest tests -q

Las pruebas son offline: no se necesita ningún sistema SAP ni red. Cubren la resolución de URI, los parsers de XML alimentados con respuestas estáticas (incluido el formato de releases antiguos) y el CLI. El CI ejecuta la suite en Linux y Windows, Python 3.10 y 3.13, y verifica que el paquete compila.

Las contribuciones y los informes de problemas son bienvenidos a través de las issues. Al abrir una issue, no pegues hostname, usuario, mandante ni fragmentos de código propietario — describe el comportamiento y, si es posible, incluye la salida de sap_system_info.

Documentación

Licencia

Apache-2.0.

Proyecto independiente, sin afiliación, patrocinio ni respaldo de SAP SE. SAP, ABAP y SAP NetWeaver son marcas de SAP SE. La herramienta solo consume la API ADT documentada públicamente, con las credenciales del propio usuario.