MCP Server

Welcome to @cap-js/mcp-server

About This Project

A Model Context Protocol (MCP) server for the SAP Cloud Application Programming Model (CAP). Use it for AI-assisted development of CAP applications (agentic coding).

The server helps AI models answer questions such as:

• Which CDS services are in this project, and where are they served?
• What are the entities about and how do they relate?
• How do I add columns to a select statement in CAP Node.js?

Table of Contents

• About This Project
• Requirements
• Setup
• Usage in VS Code
• Usage in Claude Code
• Usage in OpenAI Codex
• Usage in opencode
• CLI Usage
• Available Tools
• search_model
• search_docs
• Support, Feedback, Contributing

Requirements

See Getting Started on how to jumpstart your development and grow as you go with SAP Cloud Application Programming Model.

Setup

Configure your MCP client (Cline, opencode, Claude Code, GitHub Copilot, etc.) to start the server using the command npx -y @cap-js/mcp-server as in the following examples.

Usage in VS Code

Example for VS Code extension Cline:

{
  "mcpServers": {
    "cds-mcp": {
      "command": "npx",
      "args": ["-y", "@cap-js/mcp-server"],
      "env": {}
    }
  }
}

Example for VS Code global mcp.json:

Note: GitHub Copilot uses the mcp.json file as source for it's Agent mode.

{
  "servers": {
    "cds-mcp": {
      "command": "npx",
      "args": ["-y", "@cap-js/mcp-server"],
      "env": {},
      "type": "stdio"
    },
    "inputs": []
  }
}

See VS Code Marketplace for more agent extensions.

Usage in Claude Code

Register the server with Claude Code:

claude mcp add cds-mcp -- npx -y @cap-js/mcp-server

Usage in OpenAI Codex

Register the server with OpenAI Codex:

codex mcp add cds-mcp -- npx -y @cap-js/mcp-server

Usage in opencode

Example for opencode:

{
  "mcp": {
    "cds-mcp": {
      "type": "local",
      "command": ["npx", "-y", "@cap-js/mcp-server"],
      "enabled": true
    }
  }
}

Rules

The following rules help the LLM use the server correctly:

- You MUST search for CDS definitions, like entities, fields and services (which include HTTP endpoints) with cds-mcp, only if it fails you MAY read \*.cds files in the project.
- You MUST search for CAP docs with cds-mcp EVERY TIME you create, modify CDS models or when using APIs or the `cds` CLI from CAP. Do NOT propose, suggest or make any changes without first checking it.

Add these rules to your existing global or project-specific AGENTS.md (specifics may vary based on respective MCP client).

CLI Usage

You can also use the tools directly from the command line.

npm i -g @cap-js/mcp-server

This will provide the command cds-mcp, with which you can invoke the tools directly as follows.

# Search for CDS model definitions
cds-mcp search_model . Books entity

Shortened. The full README is on GitHub.