{"id":31764373,"url":"https://github.com/cap-js/mcp-server","last_synced_at":"2025-10-09T23:51:04.170Z","repository":{"id":310463896,"uuid":"961105832","full_name":"cap-js/mcp-server","owner":"cap-js","description":"MCP server for AI-assisted development of CAP applications","archived":false,"fork":false,"pushed_at":"2025-09-26T09:25:22.000Z","size":92868,"stargazers_count":41,"open_issues_count":5,"forks_count":6,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-09-26T11:27:02.873Z","etag":null,"topics":["agentic-coding","ai","cap","cds","mcp","mcp-server","nodejs","sap-btp","sap-cap","vibe-coding"],"latest_commit_sha":null,"homepage":"https://cap.cloud.sap/docs","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cap-js.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-05T19:05:08.000Z","updated_at":"2025-09-23T20:08:33.000Z","dependencies_parsed_at":"2025-09-02T12:21:12.471Z","dependency_job_id":"84a90ae7-a96d-49af-a11b-2d29e9350834","html_url":"https://github.com/cap-js/mcp-server","commit_stats":null,"previous_names":["cap-js/mcp-server"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/cap-js/mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cap-js%2Fmcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cap-js%2Fmcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cap-js%2Fmcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cap-js%2Fmcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cap-js","download_url":"https://codeload.github.com/cap-js/mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cap-js%2Fmcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002300,"owners_count":26083342,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-coding","ai","cap","cds","mcp","mcp-server","nodejs","sap-btp","sap-cap","vibe-coding"],"created_at":"2025-10-09T23:50:59.288Z","updated_at":"2025-10-09T23:51:04.161Z","avatar_url":"https://github.com/cap-js.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Welcome to @cap-js/mcp-server\n\n[![REUSE status](https://api.reuse.software/badge/github.com/cap-js/mcp-server)](https://api.reuse.software/info/github.com/cap-js/mcp-server)\n\n\n\n\u003e [!NOTE]\n\u003e This project is in alpha state.\n\n\n\n## About This Project\n\nA Model Context Protocol (MCP) server for the [SAP Cloud Application Programming Model (CAP)](https://cap.cloud.sap).\nUse it for AI-assisted development of CAP applications (_agentic coding_).\n\nThe server helps AI models answer questions such as:\n- _Which CDS services are in this project, and where are they served?_\n- _What are the entities about and how do they relate?_\n- _How do I add columns to a select statement in CAP Node.js?_\n\n\n\n## Table of Contents\n\n- [About This Project](#about-this-project)\n- [Requirements](#requirements)\n- [Setup](#setup)\n  - [Usage in VS Code](#usage-in-vs-code)\n  - [Usage in opencode](#usage-in-opencode)\n  - [CLI Usage](#cli-usage)\n- [Available Tools](#available-tools)\n  - [`search_model`](#search_model)\n  - [`search_docs`](#search_docs)\n- [Support, Feedback, Contributing](#support-feedback-contributing)\n- [Security / Disclosure](#security--disclosure)\n- [Code of Conduct](#code-of-conduct)\n- [Licensing](#licensing)\n- [Acknowledgments](#acknowledgments)\n\n\n\n## Requirements\n\nSee [Getting Started](https://cap.cloud.sap/docs/get-started) on how to jumpstart your development and grow as you go with SAP Cloud Application Programming Model.\n\n\n\n## Setup\n\n```sh\nnpm i -g @cap-js/mcp-server\n```\n\nThis will provide the command `cds-mcp` to start the CAP MCP server.\n\nConfigure your MCP client (Cline, opencode, Claude Code, GitHub Copilot, etc.) to start the server using the `cds-mcp` command.\n\n### Usage in VS Code\n\nExample for VS Code extension [Cline](https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev):\n```json\n{\n  \"mcpServers\": {\n    \"cds-mcp\": {\n      \"command\": \"cds-mcp\",\n      \"args\": [],\n      \"env\": {}\n    }\n  }\n}\n```\n\nExample for VS Code global [mcp.json](https://code.visualstudio.com/docs/copilot/customization/mcp-servers):\n\u003e Note: GitHub Copilot uses the `mcp.json` file as source for it's Agent mode.\n```json\n{\n\t\"servers\": {\n\t\t\"cds-mcp\": {\n\t\t\t\"command\": \"cds-mcp\",\n\t\t\t\"args\": [],\n\t\t\t\"env\": {},\n\t\t\t\"type\": \"stdio\"\n\t\t},\n\t\"inputs\": []\n}\n```\n\nSee [VS Code Marketplace](https://marketplace.visualstudio.com/search?term=tag%3Aagent\u0026target=VSCode\u0026category=All%20categories\u0026sortBy=Relevance) for more agent extensions.\n\n### Usage in opencode\n\nExample for [opencode](https://github.com/sst/opencode):\n```json\n{\n  \"mcp\": {\n    \"cds-mcp\": {\n      \"type\": \"local\",\n      \"command\": [\"cds-mcp\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n\n### Rules\n\nThe following rules help the LLM use the server correctly:\n\n```markdown\n- 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.\n- 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.\n```\n\nAdd these rules to your existing global or project-specific [`AGENTS.md`](https://agents.md/) (specifics may vary based on respective MCP client).\n\n### CLI Usage\n\nFor experimental purposes, you can also use the tools directly from the command line:\n\n```sh\n# Search for CDS model definitions\ncds-mcp search_model . Books entity\n\n# Search CAP documentation\ncds-mcp search_docs \"how to add columns to a select statement in CAP Node.js\" 1\n```\n\n## Available Tools\n\n\u003e [!NOTE]\n\u003e Tools are meant to be used by AI models and do not constitute a stable API.\n\nThe server provides these tools for CAP development:\n\n### `search_model`\n\nThis tool performs fuzzy searches against names of definitions from the compiled CDS model (Core Schema Notation).\nCDS compiles all your `.cds` files into a unified model representation that includes:\n- All definitions and their relationships\n- Annotations\n- HTTP endpoints\n\nThe fuzzy search algorithm matches definition names and allows for partial matches, making it easy to find entities like \"Books\" even when searching for \"book\".\n\n### `search_docs`\n\nThis tool uses vector embeddings to locally search through preprocessed CAP documentation, stored as embeddings. The process works as follows:\n\n1. **Query processing:** Your search query is converted to an embedding vector.\n2. **Similarity search:** The system finds documentation chunks with the highest semantic similarity to your query.\n\nThis semantic search approach enables you to find relevant documentation even when your query does not use the exact keywords found in the docs, all locally on your machine.\n\n\n## Support, Feedback, Contributing\n\nThis project is open to feature requests/suggestions, bug reports, and so on, via [GitHub issues](https://github.com/cap-js/mcp-server/issues). Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our [Contribution Guidelines](CONTRIBUTING.md).\n\n\n\n## Security / Disclosure\n\nIf you find any bug that may be a security problem, please follow our instructions at [in our security policy](https://github.com/cap-js/mcp-server/security/policy) on how to report it. Please don't create GitHub issues for security-related doubts or problems.\n\n\n\n## Code of Conduct\n\nWe as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its [Code of Conduct](https://github.com/cap-js/.github/blob/main/CODE_OF_CONDUCT.md) at all times.\n\n\n\n## Licensing\n\nCopyright 2025 SAP SE or an SAP affiliate company and @cap-js/cds-mcp contributors. Please see our [LICENSE](LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/cap-js/mcp-server).\n\n\n\n## Acknowledgments\n\n- **onnxruntime-web** is used for creating embeddings locally.\n- **@huggingface/transformers.js** is used to compare the output of the WordPiece tokenizer.\n- **@modelcontextprotocol/sdk** provides the SDK for MCP.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcap-js%2Fmcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcap-js%2Fmcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcap-js%2Fmcp-server/lists"}