关于这个项目

一款用于SAP云应用编程模型（CAP）的模型上下文协议（MCP）服务器。 利用它进行AI辅助开发CAP应用（agentic coding）。

服务器帮助AI模型回答诸如以下问题：

• Which CDS服务包含在本项目中，它们在哪里提供？
• 这些实体_What在，它们之间有何关系？_
• How 我是否需要在 CAP Node.js 的 select 语句中添加列？

目录

• 关于本项目
• 要求
• 设置
• VS Code 中的使用
• Claude 代码中的使用
• OpenAI Codex 中的使用
• 开源代码中的使用
• CLI 使用
• 可用工具
• search_model
• search_docs
• 支持、反馈、贡献
• 安全/披露
• 行为准则
• 许可
• 致谢

要求

请参阅“入门指南”，了解如何通过SAP云应用编程模型启动开发并不断成长。

布置

配置你的MCP客户端（Cline、opencode、Claude Code、GitHub Copilot等）使用命令npx -y @cap-js/mcp-server启动服务器，如下示例所示。

Claude 代码中的使用

用Claude代码注册服务器。

所有项目（用户范围）:

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
  • Environment Variables
• Available Tools
  • search_model
  • search_docs
• Support, Feedback, Contributing
• Security / Disclosure
• Code of Conduct
• Licensing
• Acknowledgments

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 Claude Code

Register the server with Claude Code.

For all projects (user scope):

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

For the current project only (local scope, not committed):

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

For the current project only (committed to the repository):

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

To set an environment variable, add --env before the server name:

claude mcp add --scope user --env CDS_MCP_MODEL=nomic-ai/nomic-embed-text-v1.5 cds-mcp -- npx -y @cap-js/mcp-server

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": {},