[Changelog] [Github repo]
This package includes a Model Context Protocol (MCP) server for integration with AI coding assistants.
The server helps AI models create or modify SAP Fiori applications based on prompts, such as:
-
Please add a SAP Fiori elements list report app to my CAP project
-
Generate a new CAP project and SAP Fiori app based on my_picture.png
-
Generate a new SAP Fiori elements list report app for odata service https://hostname:port/sap/opu/odata4/sap/my_v4_service?sap-client=000.
ℹ️This prompt requires a saved SAP system connection by using the Connection Manager for SAP Systems extension.
-
Add the FCL to the SAP Fiori elements app
-
Enable initial load for the fiori app
For the best experience we recommend using this server alongside @cap-js/mcp-server and @ui5/mcp-server.
The server uses stdio transport and is launched via npx — no global installation required. Pick the section for your MCP client below.
Note: Replace <version> with the specific version you want to pin to (e.g. 1.12.2). The current release version is shown on the npm page. Using a pinned version rather than @latest ensures reproducible behaviour and prevents untested updates from being picked up automatically.
Claude Code
Option A — CLI (recommended):
Option B — drop a .mcp.json file in your project root:
Cline
Open the Cline extension settings and add the server under MCP Servers:
Cursor
Edit (or create) the MCP config file for your scope:
- Global:
~/.cursor/mcp.json
- Project:
.cursor/mcp.json in your project root
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json:
Other clients
For any other MCP client, use the following npx-based configuration:
Global npm install (any client)
If you prefer not to use npx, install the package globally first:
Then use fiori-mcp as the command (no args needed):
The following rules help guide the AI model to use the server correctly. Add them to your system prompt or rules file:
- Claude Code:
AGENTS.md or CLAUDE.md in your project root
- Cline: Custom Instructions in the Cline extension settings
- Cursor:
.cursorrules in your project root
- Windsurf: Global Rules or project-level
.windsurfrules
search_docs
Searches SAP Fiori elements, Annotations, UI5, OPA5 Guides, SAP Fiori tools documentation for the given query.
Note: the results are based on the most recent indexed version of UI5 documentation
First-use download: search_docs uses a local text-embedding model (all-MiniLM-L6-v2, ~86 MB) for semantic search. The model is downloaded from HuggingFace Hub on first use and cached locally (location follows the HF_HOME / TRANSFORMERS_CACHE environment variables, defaulting to ~/.cache/huggingface/hub). Subsequent starts load the model from the cache with no network access required.
list_fiori_apps
Scans a specified directory to find existing SAP Fiori applications that can be modified.
list_sap_systems
Lists all SAP systems stored in the user's environment (e.g. SAP Fiori tools system store). Use this when the user references a SAP system by name before calling download_odata_service_metadata or generating a Fiori application.
download_odata_service_metadata
Downloads the EDMX metadata of a specific OData service from a SAP system and saves it as metadata.xml. Use this before calling generate_fiori_app_odata when the user provides a SAP system reference or service URL.
generate_fiori_app_odata
Generates a new SAP Fiori UI application for OData (non-CAP) projects, for example ABAP RESTful Application Programming Model-based OData services.
generate_fiori_app_cap
Generates a new SAP Fiori UI application within an existing SAP Cloud Application Programming Model (CAP) project.
list_functionality (Step 1 of 3)
Gets the list of supported modification functionalities for an existing SAP Fiori application. Requires a valid absolute path to the application.
The supported modifications are:
- Adding and deleting pages from an app
- Adding and modifying controller extensions
- Modifying
manifest.json properties depending on the app, for example, adding a layout based on the flexibility of the programming model or enabling initial load
get_functionality_details (Step 2 of 3)
Gets the required parameters and detailed information for a specific functionality to modify an existing SAP Fiori application.
execute_functionality (Step 3 of 3)
Executes a specific functionality to modify an existing SAP Fiori application with provided parameters.
By default, logging is enabled at the error level. To adjust the log level or disable logging completely, you can use the env property in your configuration.
The following log levels are supported: off, error, warn, info, debug, and verbose.
The logs are stored in the file system at ~/.fioritools/fiori-mcp-server.log
If you need the MCP server to connect to an OData server using a self-signed SSL certificate, you can use one of the following methods.
This is useful when encountering errors such as: unable to get local issuer certificate
Option 1: Add Custom CA Certificate (Recommended)
Set the NODE_EXTRA_CA_CERTS environment variable to the path of your CA certificate file. Node.js supports multiple file extensions (.pem, .crt, .cer, .cert).
Example Configuration:
Windows Example:
macOS/Linux Example:
Option 2: Bypass SSL Validation (Not Recommended)
⚠️ Security Warning: Setting NODE_TLS_REJECT_UNAUTHORIZED=0 disables all SSL certificate validation and poses a significant security risk. Only use this in non-production environments.
Additional Resources
You can enable and disable the collection of analytics. By default, non-personally identifiable information is used to help understand how you use the product to improve the Fiori MCP Server. In case you want to opt-out there exist two ways to disable the telemetry.
Method 1: Configuration File
Create or change the file ~/.fioritools/telemetrysettings.json:
Set enableTelemetry to false to disable telemetry collection.
Method 2: Environment Variable
Set the environment variable SAP_UX_FIORI_TOOLS_DISABLE_TELEMETRY to true:
Setting this environment variable will disable the telemetry client.
Code of Conduct
Everyone participating in this joint project is welcome as long as our Code of Conduct is being adhered to.
Licensing
Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.