convez.ai
MCP ServerIntegração & APIsAvançado
Nidhideep

SAP S/4HANA MCP Server

Nidhideep/sap-s4-mcp-server

Acesso OData nativo ao SAP S/4HANA direto do Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para acesso a OData do SAP S/4HANA, permitindo descoberta de serviços, consultas de entidades, leitura de metadados e operações CRUD completas. Integra-se nativamente com Claude via Model Context Protocol, eliminando a necessidade de chamadas HTTP manuais.

Instalação

$npx convez-ai Nidhideep/sap-s4-mcp-server

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
5
Forks
2
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Consultar dados maestros (materiais, clientes, fornecedores) do SAP
  • Automatizar criação e atualização de documentos (pedidos, faturas)
  • Explorar estrutura de metadados e validar valores de dropdown
  • Integrar processos SAP em fluxos de IA sem APIs intermediárias

Veredito

Ferramenta robusta e bem-documentada para empresas SAP que precisam de acesso estruturado a S/4HANA via Claude. Exige conhecimento prévio de OData, autenticação SAP e ambiente Node.js configurado — recomendado apenas para equipes técnicas com expertise em ERP.

README

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

SAP S4 MCP Server

MCP server for SAP S/4HANA OData access. Discover services, query entities, fetch metadata, and manage data — built on the @modelcontextprotocol/sdk TypeScript SDK.

Tools

ToolDescription
discover_sap_servicesDiscovers available services from the SAP Gateway Service Catalog
get_entity_metadataFetches and summarizes OData service metadata optimized for LLM consumption
get_field_valuesFetches dropdown/value-list values from SAP OData entities
execute_odata_queryExecutes OData CRUD operations (GET returns CSV, writes return JSON)

Prerequisites

  • Node.js >= 18.0.0
  • SAP S/4HANA system with OData services enabled
  • SAP user with appropriate OData authorizations

Setup

git clone https://github.com/Nidhideep/sap-s4-mcp-server
cd sap-s4-mcp-server
npm install
cp .env.example .env
# Edit .env with your SAP connection details
npm run build

Environment Variables

Copy .env.example to .env and fill in the values.

OData Connection (required)

VariableDescriptionExample
S4_ODATA_HOSTFull SAP S/4HANA URL including scheme and porthttps://my-s4.sap:44301
S4_ODATA_CLIENTSAP client number100
AUTH_METHODbasic or tokenbasic
S4_ODATA_USERSAP user (when AUTH_METHOD=basic)ODATA_USER
S4_ODATA_PASSWORDPassword (when AUTH_METHOD=basic)
S4_ODATA_TOKENBearer token (when AUTH_METHOD=token)

Operational

VariableDescriptionDefault
LOG_LEVELdebug, info, warn, errorinfo
DRY_RUNWhen true, all write operations are blockedfalse

MCP Client Configuration

Claude Code

claude mcp add sap-s4-mcp-server -- node /absolute/path/to/sap-s4-mcp-server/dist/src/index.js

Then set env vars via .mcp.json (copy from .mcp.example.json).

Claude Desktop / Cline

Copy .mcp.example.json to .mcp.json, fill in real values, and add to your MCP client config:

{
  "mcpServers": {
    "sap-s4-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/sap-s4-mcp-server/dist/src/index.js"],
      "env": {
        "S4_ODATA_HOST": "https://your-s4.example.com:44301",
        "S4_ODATA_CLIENT": "100",
        "AUTH_METHOD": "basic",
        "S4_ODATA_USER": "your_user",
        "S4_ODATA_PASSWORD": "your_password"
      }
    }
  }
}

Recommended Workflow

  1. Discover — discover_sap_services to find the service name
  2. Understand — get_entity_metadata to see entity sets and field names
  3. Validate inputs — get_field_values to look up valid dropdown values
  4. Query or write — execute_odata_query with the correct service, entity, and fields

Project Structure

src/
  index.ts              # Server entry point (stdio transport)
  server.ts             # Tool registration
tools/
  s4-discover-services.tool.ts   # Gateway catalog discovery
  s4-metadata.tool.ts            # OData $metadata parser
  s4-field-values.tool.ts        # Value-list / dropdown fetcher
  s4-odata-query.tool.ts         # CRUD query executor
config/
  env.ts                # Zod-validated environment config
  auth.ts               # Auth headers + CSRF token fetch
  policy.ts             # DRY_RUN enforcement + audit log
docs/
  authentication.md
  governance.md
  troubleshooting.md
examples/
  example-workflow.md

Development

npm run dev        # Watch mode with tsx
npm run typecheck  # Type-check without building
npm run build      # Compile to dist/

Governance

  • DRY_RUN=true blocks all write operations — safe for read-only environments
  • All write operations are audit-logged to stderr
  • CSRF tokens are fetched automatically before every write
  • No credentials are ever committed — use .env (gitignored) or MCP client env injection
Ver o original no GitHub

Bom para

Relacionados