convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
palimkarakshay

abap-mcp — Análise Estática de ABAP Offline

palimkarakshay/abap-mcp

Lint, Cloud-readiness check e RAP scaffolding para ABAP offline, integrado com Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que fornece análise estática de código ABAP (abaplint), verificação de prontidão para ABAP Cloud/Clean Core e scaffolding de RAP, sem necessidade de sistema SAP. 100% local, sem chamadas de rede, funciona diretamente com fonte de texto (repositórios Git, exports abapGit, reviews de código).

Instalação

$npx convez-ai palimkarakshay/abap-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
1
Saúde
42%
Último commit
há 3 dias
Versão
v0.12.9
Issues abertas
1
Contribuidores
1

Casos de uso

  • Validar qualidade de código ABAP em CI/CD sem SAP system
  • Migrar código legado para ABAP Cloud/Clean Core com feedback automático
  • Gerar estrutura de Business Objects RAP e verificar APIs liberadas
  • Revisar PRs de repositórios abapGit com análise estática antes do transporte
  • Navegar e documentar classes ABAP complexas para equipes

Veredito

Ferramenta sólida e diferenciada: preenche a lacuna entre edição local de código e feedback de qualidade ABAP sem acesso a sistema SAP. Ideal para fluxos CI, migrações e code review em abapGit. CLI + MCP tornam-na versátil para agentes e automação.

README

A tradução para o português deste README ainda está na fila.

abap-mcp

MCP server for SAP ABAP — offline static analysis, ABAP Cloud readiness, and RAP scaffolding. No SAP system. No credentials. Works on ABAP source wherever your AI agent works: a git checkout, an abapGit export, a code review, CI.

Built on abaplint (the open-source ABAP parser/linter) and the Model Context Protocol. TypeScript, 100% local — the server makes zero network calls and reads no user files: sources go in as text, findings come back as structured JSON. (The released-API list and abaplint's rule data are package-bundled assets that ship inside the install — no network, no user filesystem, at runtime.)

Why this exists

Every other ABAP MCP server is either a bridge to a live SAP system (ADT/RFC — needs credentials, a system, and trust) or a documentation search. But AI coding agents spend most of their time where the files are — editing abapGit repos, reviewing diffs, generating code — long before anything reaches a system. This server gives agents the missing feedback loop at that layer:

  • "Does this ABAP parse? Is it clean?" → lint_abap
  • "How far is this classic report from ABAP Cloud?" → check_cloud_readiness
  • "Is MARA a released API? What do I use instead?" → check_released_api
  • "Start me a correct RAP business object." → scaffold_rap_bo
  • "What's in this 4,000-line class?" → get_abap_outline

Quickstart

# Claude Code
claude mcp add abap-mcp -- npx -y abap-mcp

# or any MCP client (.mcp.json / mcp.json):
{
  "mcpServers": {
    "abap-mcp": { "command": "npx", "args": ["-y", "abap-mcp"] }
  }
}

From a clone instead:

npm install && npm run build
claude mcp add abap-mcp -- node /path/to/abap-mcp/dist/cli.js

Then ask your agent things like "lint this class against ABAP Cloud", "is zold_report cloud-ready?", or "scaffold a RAP BO for entity Booking on table zbooking, draft enabled".

CLI — same engine, no AI required

Every tool is also a subcommand, so it works in terminals and CI where no MCP client exists:

npx abap-mcp lint src/                          # lint files or whole directories
npx abap-mcp readiness src/ --fail-below 80     # repo-level ABAP Cloud readiness, CI-gateable
npx abap-mcp scaffold --entity Travel --table ztravel --key travel_id --out ./out
npx abap-mcp outline src/zcl_monster.clas.abap  # navigate big objects
npx abap-mcp released MARA I_Product            # released-API status + CDS successor
npx abap-mcp explain exit_or_check              # rule rationale

Directories are walked recursively (abapGit naming), batched automatically, and readiness merges batches into one scored, categorized repo report. Exit codes are CI-friendly (1 on error findings / failed threshold).

Recipes, agents & CI

docs/COOKBOOK.md — practical recipes: the fix-until-clean loop, PR review without a transport, whole-repo migration triage, CI gates, per-persona use cases. examples/claude-code/ — drop-in agentic workflows: an abap-code-reviewer subagent, an abap-cloud-migrator sweep loop (readiness score as the loop condition), per-repo .mcp.json, and a GitHub Actions quality gate for abapGit repos.

Tools

ToolWhat it does
lint_abapabaplint static analysis over ABAP/CDS/BDEF sources → structured findings with rule docs links. Presets: style (default, snippet-friendly), full, syntax-only; per-rule overrides.
check_cloud_readinessDual-parse diff (classic baseline vs Cloud): statements that are valid today but illegal in ABAP Cloud become categorized blockers (dynpro, list output, native SQL, …) with a transparent score; code broken at the baseline is reported separately, not counted as migration work. Now also surfaces a separate, dated released-API cross-check (releasedApiFindings): direct access to non-released classic tables and deprecated-API usage found in the source, with CDS successor hints — informational, not folded into the score.
check_released_apiLooks up objects (tables, CDS views, function modules, classes, …) in SAP's bundled Cloudification snapshot → released / deprecated / not-released per object, plus a curated CDS successor for common classic tables. The released-API half of readiness, offline.
scaffold_rap_boGenerates the canonical RAP managed-BO stack (root view, behavior definition strict(2) + optional draft, behavior class + handler locals, projection, metadata extension, OData V4 service definition) plus suggested table DDL, activation order and next steps.
list_abap_rulesBrowse abaplint's ~180 rules (filter by text or tag).
explain_abap_ruleOne rule in depth — rationale (often Clean ABAP), examples, docs URL.
format_abapOffline pretty-printer (keyword case + indentation).
get_abap_outlineClasses/methods/visibility/interfaces/FORMs of a source — navigate big objects without reading them whole.

Honesty box — what this is not

  • Not ATC. The objective readiness score is still language-level: statements ABAP Cloud removed. Released-API coverage is now partial and offline: check_released_api and the releasedApiFindings in readiness reflect SAP's published Cloudification list as of the bundled snapshot date — they cover tables and function modules referenced in your source, not every API, and are only as current as the snapshot. A target system's own released-API list (ATC check API_RELEASE_STATE_CHECK / SAP_CP_READINESS) remains authoritative; treat an "absent from the list" result as "not released as of the snapshot", not as proof.
  • Scaffold validation is tiered. Generated classes and CDS views are round-tripped through abaplint at Cloud level before they're returned (the generator and the linter share one parser). Behavior/service definitions are outside abaplint's checked surface — they are golden-tested canonical templates, and ADT activation is the final arbiter. Each generated file is labeled validated: "abaplint" | "template".
  • Text-in only, by design. No user-filesystem walking, no network — the entire attack surface is a parser over strings you explicitly pass. (The released-API snapshot and abaplint's rule data are package-bundled assets imported from the install, not fetched or read from your disk.) For linting whole directories, use the abaplint CLI in CI, or the mcp-kit wrap-abaplint recipe this server grew out of.

Develop

npm install
npm run check     # typecheck + 115 tests + build — the CI gate
node dist/cli.js  # stdio MCP server
npx @modelcontextprotocol/inspector --cli node dist/cli.js --method tools/list

Tool descriptions are CI-graded (a rubric test enforces verb-first names, when-to-use, non-goals, described params, worked examples — the mcp-kit discipline; the full mcp-kit lint scores all eight tools 100/100).

Design

The decision log — why offline, why abaplint, why a dual-parse readiness diff, why the scaffolder validates its own output, what was deliberately left out — lives in docs/DESIGN.md.

Credits

  • abaplint by Lars Hvam — the parser and rule engine underneath every tool here (MIT).
  • SAP/abap-atc-cr-cv-s4hc — SAP's official ABAP Cloudification Repository (object release list), Apache-2.0. The bundled released-API snapshot (src/data/released-apis.json, snapshot 2026-06-10) is a compact transform of that data, redistributed under Apache-2.0 with attribution; see docs/DESIGN.md and scripts/build-released-api-index.mjs for the pipeline.
  • mcp-kit — the production-MCP patterns this server follows (typed tool specs, transport discipline, description lint).

MIT © Akshay Palimkar. Not affiliated with or endorsed by SAP SE. "SAP", "ABAP" and "RAP" are trademarks of SAP SE; this is an independent open-source tool for developers working with them.

Ver o original no GitHub

Bom para

Relacionados