mdk-mcp

Welcome to @sap/mdk-mcp-server

What is MCP server for mobile development kit?

This open-source server provides AI agents with comprehensive MDK knowledge and tools. By combining best practice guidelines, project-aware context information, templates for creating new projects, and access to the MDK CLI tools, the MDK MCP server transforms AI agents into MDK development experts.

What is mobile development kit?

The SAP Mobile Development Kit (MDK) is a powerful framework that enables developers to build cross-platform mobile applications using a metadata-driven approach. It is part of SAP Business Technology Platform and integrates tightly with SAP Mobile Services. Some of SAP’s larger and complex mobile apps are built using MDK. An example is SAP Service and Asset Manager.

[!NOTE] This MCP server is an early release version of the MDK. You may encounter bugs or unfinished features. We'd love your feedback to make it better! Please report issues or share suggestions via GitHub issues.

Table of Contents

• Setup
• Available Tools
• Support, Feedback, Contributing
• Telemetry
• Security / Disclosure
• Code of Conduct
• Licensing
• Acknowledgments

Setup

1. Install node.js 22.14.0.

2. For installing the MDK MCP server, we offer two options:

   a. Use npm to install it from the public npmjs registry at @sap/mdk-mcp-server.

   npm install -g @sap/mdk-mcp-server 
   

   b. Clone the open-source code repository at https://github.com/SAP/mdk-mcp-server, and use npm to install.

   git clone https://github.com/SAP/mdk-mcp-server.git 
   cd mdk-mcp-server 
   npm i --include=optional 
   npm run build
   npm i -g @sap/mdk-mcp-server@. 
   

3. Configure your MCP client (AI agent) to connect to the server. Configuration will vary depending on the AI agent used.

   Cline in VS Code: Example using the Cline extension.

   • With Cline open, look below the prompt box and click Manage MCP Servers.
   • In the dialog, click Settings. The MCP Servers page opens.
   • Click Configure MCP Servers. This will open the cline_mcp_settings.json file in your editor.
   • In the JSON settings file, add a configuration block for MDK MCP server within the mcpServers section, and save the file. The supported schema versions include 26.3(default), 25.9, 25.6, 24.11, and 24.7.

   {
     "mcpServers": {
       "mdk-mcp": {
         "type": "stdio",
         "command": "mdk-mcp",
         "args": ["--schema-version", "26.3"]
       }
     }
   }
   

   Note:
   If the MCP server does not listed with its available tools in the Cline extension immediately, restart VS Code.

   Expand: Usage in OpenCode

   Example using OpenCode:

   {
     "mcp": {
       "mdk-mcp": {
         "type": "local",
         "command": ["mdk-mcp", "--schema-version", "26.3"],
         "enabled": true
       }
     }
   }
   

   Expand: Usage in Cursor

   Edit the file ~/.cursor/mcp.json:

   {
     "mcpServers": {
       "mdk-mcp": {
         "command": "mdk-mcp",
         "args": ["--schema-version", "26.3"]
       }
     }
   }
   

   Once configured, your AI agent will have access to the MDK MCP server. Depending on your IDE settings, you may need to approve initial tool calls.

4. Create a Rule File: To ensure your AI coding assistant uses the MCP servers appropriately for your project, define rules and guidelines in a file named AGENTS.md. In the Cline extension for VS Code, click the Manage Cline Rules & Workflows icon below the prompt box, click + to create a new rule file (e.g., AGENTS.md) and add the above contents.

   Example rules to guide agent behavior:

   - Don't generate `.service.metadata` file.
   - Don't generate `.xml` file in the `Services` folder.
   - Don't change `.project.json` file.