{"ref":"artifact:shahid-la-cds-db-nlquery-mcp","page":"/artifacts/shahid-la-cds-db-nlquery-mcp","json":"/artifacts/shahid-la-cds-db-nlquery-mcp.json","generated":"2026-11-15","drafted_with_ai":true,"entity":{"id":"shahid-la-cds-db-nlquery-mcp","name":"@shahid.la/cds-db-nlquery-mcp","artifact_type":"mcp-server","ecosystem":"cap","domain":"ai-and-agents","origin_ring":"independent","description":{"one_line":"MCP server that answers plain-English questions against the entities in db/schema.cds — it discovers the schema, generates CQN-backed SQL with real joins, and returns rows.","short":"MCP server answering plain-English questions against a CDS schema","what_it_solves":"Bring your own model: Anthropic, OpenAI, or any OpenAI-compatible endpoint. It reads the db layer rather than a service, so there is no per-query configuration and no hand-written SQL — which is also the caution, since it reaches past whatever a service would have restricted."},"links":{"npm":"https://www.npmjs.com/package/@shahid.la/cds-db-nlquery-mcp","repo":"https://github.com/shahidla/cds-db-nlquery-mcp"},"identity":{"author":"shahid.la","license":"MIT"},"compat":{"runtimes":["node"]},"provides":[{"capability":"capability:mcp-servers","facets":[{"key":"mcp_exposure_source","value":["CDS database schema"],"source":{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"**Targets the `db/` layer, not OData services.**","checked":"2026-10-12"},"applies_to":{"ecosystems":["cap"],"flavors":["node"]},"sources":[{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"**Targets the `db/` layer, not OData services.**","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"| `MCP_MODEL_PATH` | `db` | Path to your CDS model folder or file, relative to `cwd`.","checked":"2026-10-12"}]},{"key":"mcp_operations","value":["query"],"source":{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"**Read-only.** This package only executes SELECT queries. No INSERT, UPDATE, or DELETE.","checked":"2026-10-12"},"applies_to":{"ecosystems":["cap"],"flavors":["node"]}},{"key":"mcp_execution_path","value":["Direct database queries"],"source":{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"this package queries the database directly via `cds.run()`","checked":"2026-10-12"},"sources":[{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"which translates it into a structured query descriptor.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"CDS association paths (`customer.BU_SORT1`) generate real SQL JOINs, executed by your database, not by JavaScript.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"**Targets the `db/` layer, not OData services.**","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"this package queries the database directly via `cds.run()`","checked":"2026-10-12"}],"applies_to":{"ecosystems":["cap"],"flavors":["node"]}},{"key":"mcp_exposure_control","value":["Entity allowlist","Output filtering","CAP service authorization bypassed"],"source":{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"| `MCP_ALLOWED_ENTITIES` | *(all entities)*","checked":"2026-10-12"},"sources":[{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"| `MCP_ALLOWED_ENTITIES` | *(all entities)*","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"| `MCP_BLOCKED_COLUMNS` | *(none)*","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"This is enforced on the entity you query directly **and** on any entity reached via\nan association join in `select`/`where`.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"It does **not** go through the CAP service layer, so CAP `@requires` and `@restrict` annotations are **not enforced**. Access control is entirely your responsibility at the database and configuration level.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"Comma-separated column names to exclude from all results. Stripped before the query runs.","checked":"2026-10-12"}],"applies_to":{"ecosystems":["cap"],"flavors":["node"]}}],"what_it_does":"Queries CDS database-layer entities from a CAP [Node.js](external:nodejs) project through an LLM-planned SELECT query, including database-executed association joins. It targets the database layer with a default model path of db/ and executes no INSERT, UPDATE or DELETE. MCP_ALLOWED_ENTITIES restricts direct queries and joined entities; its default allows all entities. MCP_BLOCKED_COLUMNS excludes result columns before execution. CAP service-level @requires/@restrict are not enforced; database permissions and configuration control access.","sources":[{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"**Targets the `db/` layer, not OData services.**","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"**Read-only.** This package only executes SELECT queries. No INSERT, UPDATE, or DELETE.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"| `MCP_ALLOWED_ENTITIES` | *(all entities)*","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"It does **not** go through the CAP service layer, so CAP `@requires` and `@restrict` annotations are **not enforced**. Access control is entirely your responsibility at the database and configuration level.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"| `MCP_MODEL_PATH` | `db` | Path to your CDS model folder or file, relative to `cwd`.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"which translates it into a structured query descriptor.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"CDS association paths (`customer.BU_SORT1`) generate real SQL JOINs, executed by your database, not by JavaScript.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"| `MCP_BLOCKED_COLUMNS` | *(none)*","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"This is enforced on the entity you query directly **and** on any entity reached via\nan association join in `select`/`where`.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"Comma-separated column names to exclude from all results. Stripped before the query runs.","checked":"2026-10-12"},{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"this package queries the database directly via `cds.run()`","checked":"2026-10-12"}]},"capability:llm-integration"],"provenance":{"discovered_via":[{"source":"source:npm","channel":"keywords:sap-cap"}],"first_seen":"2026-09-07"},"maintainers":["actor:shahidla"],"contributors":["actor:shahidla"],"drafted_with_ai":true,"type_properties":{"read_only":{"value":true,"source":{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"cds-db-nlquery-mcp — read-only interface","quote":"**Read-only.** This package only executes SELECT queries. No INSERT, UPDATE, or DELETE.","checked":"2026-10-12"}}},"history":[{"date":"2026-10-12","field":"provides[mcp-servers].facets","from":"CDS database-layer schema; not OData service metadata; SELECT queries only; no INSERT, UPDATE or DELETE","to":"CDS database-layer schema (db/ by default); service-layer/OData exposure is outside this interface; SELECT only; no INSERT, UPDATE or DELETE; Configured LLM plans a query descriptor; CDS executes a database query and SQL joins, rather than invoking application-service operations; Direct database access bypasses CAP @requires/@restrict; MCP_ALLOWED_ENTITIES restricts direct/joined entities, MCP_BLOCKED_COLUMNS excludes result columns; unset allowlist permits all entities","reason":"Direct persistence access does not enforce service-layer annotations; the database/configuration controls and their defaults are stated explicitly."},{"date":"2026-10-12","field":"provides[mcp-servers].what_it_does","from":null,"to":"Queries CDS database-layer entities from a CAP [Node.js](external:nodejs) project through an LLM-planned SELECT query, including database-executed association joins. It targets the database layer rather than OData/application services, and executes no INSERT, UPDATE or DELETE. The entity allowlist covers direct queries and joined entities; its default allows all entities. CAP service-level @requires/@restrict are not enforced; database permissions and configuration control access.","reason":"Direct persistence access does not enforce service-layer annotations; the database/configuration controls and their defaults are stated explicitly."},{"date":"2026-10-12","field":"provides.mcp-servers.facets.mcp_exposure_source.value","from":"CDS database-layer schema (db/ by default); service-layer/OData exposure is outside this interface","to":"CDS database schema","reason":"Converts the text answer to controlled list values. Its documented conditions remain in the capability relationship; original citations and runtime scope are retained."},{"date":"2026-10-12","field":"provides.mcp-servers.facets.mcp_execution_path.value","from":"Configured LLM plans a query descriptor; CDS executes a database query and SQL joins, rather than invoking application-service operations","to":"Direct database queries","reason":"Converts the text answer to controlled list values. Its documented conditions remain in the capability relationship; original citations and runtime scope are retained."},{"date":"2026-10-12","field":"provides.mcp-servers.facets.mcp_exposure_control.value","from":"Direct database access bypasses CAP @requires/@restrict; MCP_ALLOWED_ENTITIES restricts direct/joined entities, MCP_BLOCKED_COLUMNS excludes result columns; unset allowlist permits all entities","to":"Entity allowlist; Output filtering; CAP service authorization bypassed","reason":"Converts the text answer to controlled list values. Its documented conditions remain in the capability relationship; original citations and runtime scope are retained."},{"date":"2026-10-12","field":"requires","from":"[]","to":"@sap/cds >= 7 runtime prerequisite","reason":"The README states this CAP project prerequisite; the explicit relationship records it without claiming end-to-end compatibility."},{"date":"2026-10-12","field":"provides.mcp-servers.facets.mcp_execution_path.source","from":"which translates it into a structured query descriptor.","to":"this package queries the database directly via `cds.run()`","reason":"Uses the exact direct-database execution sentence as the primary citation, retaining the prior LLM-planning quote among supporting sources."},{"date":"2026-10-12","field":"provides[mcp-servers].what_it_does","from":"Queries CDS database-layer entities from a CAP [Node.js](external:nodejs) project through an LLM-planned SELECT query, including database-executed association joins. It targets the database layer rather than OData/application services, and executes no INSERT, UPDATE or DELETE. The entity allowlist covers direct queries and joined entities; its default allows all entities. CAP service-level @requires/@restrict are not enforced; database permissions and configuration control access. The model path defaults to db/. MCP_ALLOWED_ENTITIES restricts both direct and joined entities; MCP_BLOCKED_COLUMNS excludes result columns before execution.","to":"Queries CDS database-layer entities from a CAP [Node.js](external:nodejs) project through an LLM-planned SELECT query, including database-executed association joins. It targets the database layer with a default model path of db/ and executes no INSERT, UPDATE or DELETE. MCP_ALLOWED_ENTITIES restricts direct queries and joined entities; its default allows all entities. MCP_BLOCKED_COLUMNS excludes result columns before execution. CAP service-level @requires/@restrict are not enforced; database permissions and configuration control access.","reason":"Resolves the requested review findings while preserving the structured comparison values, runtime scopes and implementation restrictions."},{"date":"2026-11-03","field":"provides.mcp_operations","from":"the sentence: SELECT only; no INSERT, UPDATE or DELETE","to":"query","reason":"ADR-0120: the facet is typed, and the sentence is read by its words; the quote it rests on is unchanged."}],"requires":[{"ref":"artifact:sap-cds","requirement":"required","role":"cap-runtime","for":"The CAP project runtime [@sap/cds](artifact:sap-cds), version 7 or later, executes the database queries required by this server.","sources":[{"url":"https://github.com/shahidla/cds-db-nlquery-mcp","title":"@shahid.la/cds-db-nlquery-mcp — README","quote":"A CAP project with `@sap/cds >= 7`","checked":"2026-10-12"}]}]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"fair","evidence":"5 months since release"},{"label":"Continuity","tier":"fair","evidence":"2 contributors, 1 publisher"},{"label":"Repository","tier":"good","evidence":"pushed 2026-07, not archived"}],"compatibility":[{"label":"Declared for","tier":"good","evidence":">=7 — includes cds 10 and 9"},{"label":"Survived majors","tier":"poor","evidence":"no release since @sap/cds 10 shipped (July 2026)"},{"label":"Maintainer's CI","tier":"fair","evidence":"no CI configured"}],"practice":[{"label":"Tests","tier":"good","evidence":"2 test files, npm test"},{"label":"Docs","tier":"good","evidence":"README 18 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":91,"unit":"installs/week"},{"value":0,"unit":"watching"}]},"signals":{"crawled_at":"2026-11-14","latest_version":"0.7.3","majors":{"0.5":{"version":"0.5.0","date":"2026-06-18"},"0.7":{"version":"0.7.0","date":"2026-06-22"}},"license":"MIT","first_release":"2026-06-18","last_release":"2026-06-25","releases":8,"cadence_days":0,"maintainers":1,"repository":"git+https://github.com/shahidla/cds-db-nlquery-mcp.git","peer_cds":">=7","test_script":true,"types":false,"downloads_weekly":91,"stars":0,"forks":0,"open_issues":0,"archived":false,"pushed_at":"2026-07-29","license_spdx":"MIT","org_owned":false,"default_branch":"main","contributors":2,"tree_truncated":false,"test_files":2,"workflows":0,"other_ci":false,"readme_bytes":18623,"docs_files":0,"changelog":false,"license_file":true,"dts_files":0,"readme_path":"README.md","readme_sha":"368629d9e90fbdd17b366139376cb17dba618e4d","months_since_release":5,"dormant":false,"repository_directory":null,"dependencies":3,"node_engine":">=18","downloads_monthly":245,"created_at":"2026-06-16T03:47:40Z","open_prs":0,"first_commit":"2026-06-16","last_commit":"2026-06-25","commits":69,"repo_read":"2026-11-14","language":"JavaScript"},"release_notes":{"license":"MIT","quotable":true,"versions":[{"version":"0.7.3","date":"2026-06-25"},{"version":"0.7.2","date":"2026-06-24"},{"version":"0.7.1","date":"2026-06-24"},{"version":"0.7.0","date":"2026-06-22"},{"version":"0.5.3","date":"2026-06-18"},{"version":"0.5.2","date":"2026-06-18"},{"version":"0.5.1","date":"2026-06-18"},{"version":"0.5.0","date":"2026-06-18"}],"crawled_at":"2026-11-15"},"edges":{"maintainers":[{"ref":"actor:shahidla","name":"shahidla","json":"/actors/shahidla.json"}],"contributors":[{"ref":"actor:shahidla","name":"shahidla","json":"/actors/shahidla.json"}],"explained_by":[{"ref":"content:natural-language-queries-for-sap-cap-via-mcp","name":"Natural Language Queries for SAP CAP via MCP: The LLM Translates, CDS Executes","json":"/content/natural-language-queries-for-sap-cap-via-mcp.json"}],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}