Skip to main content
Glama
jpnqs

Bookshop MCP Example

by jpnqs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Bookshop MCP Example

A minimal CAP bookshop sample that exposes its service via the Model Context Protocol (MCP), letting AI agents and LLM tools query it directly.

Official CAP MCP docs: https://cap.cloud.sap/docs/guides/protocols/mcp

Setup

npm install

Related MCP server: CAP MCP Plugin

Run

cds watch

The MCP server starts automatically and is registered with local MCP clients (Claude Code, Opencode).

How it works

The CatalogService in srv/cat-service.cds is annotated with @mcp, which is all that's needed to expose it as an MCP server:

annotate CatalogService with @mcp;

The adapter creates three tools per service:

Tool

Purpose

describe

Returns the data model (entities, actions, functions)

query

Reads data — supports select, where, orderBy, limit, etc.

call_action

Invokes unbound actions/functions (e.g. submitOrder, checkAvailability)

Try it

With Claude Code or Opencode running, just ask:

list books with authors and genres

Inspect tools

npm run inspector

Opens the MCP Inspector at http://localhost:5173. Connect to http://localhost:4004/mcp/browse to browse tools interactively.

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • CAP MCP Plugin

    gavdilabs
    A
    license
    Not graded
    quality
    A
    maintenance
    A CAP plugin that automatically generates MCP servers from your CAP services, transforming OData services into AI-accessible resources, tools, and prompts with minimal configuration.
    397
    61
    Apache 2.0

  • sap-mcp-server

    Volshin
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables natural language querying of SAP business partner data by exposing OData APIs as MCP tools for LLM agents.
    -