# MCP Server

> MCP Server is an open-source MCP server for developer tools. Searches a CAP project's CDS model and CAP docs to support AI-assisted SAP development. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, vscode, macOS, Windows, Linux
- **Repository:** https://github.com/cap-js/mcp-server
- **MCP Registry name:** io.github.cap-js/mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

This server is aimed at agentic coding on SAP Cloud Application Programming Model projects. It answers questions such as which CDS services a project has and where they are served, how entities relate, and how to extend a select statement in CAP Node.js.

Documentation search runs locally. The query is turned into an embedding and compared with preprocessed CAP docs stored as embeddings, and by default only chunks for the detected runtime (Node.js or Java) plus runtime-agnostic chunks are kept. Optional settings cover an offline mode, a choice of embedding model, a cap on results and a local reranking model. The README marks these variables as experimental and says the tools are meant for AI models and are not a stable API.

The README also supplies rules to paste into an AGENTS.md file, telling the model to search CDS definitions through the server before reading .cds files and to check the docs every time it changes models or uses the cds CLI. Setup examples cover Claude Code, VS Code with Cline or Copilot, OpenAI Codex and opencode, and a cds-mcp command can call the tools from a terminal.

## Features

- **CDS model search:** Finds entities, fields and services, including HTTP endpoints, in the project's CDS definitions.
- **Local doc search:** Searches preprocessed CAP documentation with embeddings, filtered to the project's runtime.
- **Optional reranking:** A local cross-encoder model can rerank documentation results when enabled.
- **Offline mode:** Uses locally cached embeddings without checking for updates.
- **Command-line use:** The cds-mcp command runs the same tools directly from a terminal.
- **Agent rules:** Ships suggested AGENTS.md rules so models check CAP docs before editing.

## Good for

- Ask which services a CAP project exposes
- Understand how entities in a CDS model relate
- Look up CAP Node.js API usage while coding
- Give a coding agent reliable CAP documentation
- Query a CDS model from the terminal

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server -- npx -y @cap-js/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `search_model`: Searches CDS definitions such as entities, fields and services in the project.
- `search_docs`: Searches preprocessed CAP documentation using local vector embeddings.

## FAQ

### How do I start it?

Configure your MCP client to run npx -y @cap-js/mcp-server.

### Which tools does it expose?

search_model for CDS definitions and search_docs for CAP documentation.

### Can it run offline?

Yes, set CDS_MCP_OFFLINE to true to use locally cached embeddings.

### Is the tool interface stable?

The README says the tools are meant for AI models and do not constitute a stable API.

### Is MCP Server free?

Yes. MCP Server is open source, so you can use and self-host it for free.

### How do I add MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mcp-server -- npx -y @cap-js/mcp-server

### What are the best alternatives to MCP Server?

The closest alternatives to MCP Server are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mcp-server-mweo0zt0
