UI5 MCP Server
UI5 애플리케이션 개발을 위한 Model Context Protocol 서버입니다.
OpenUI5 Community Slack (#tooling channel)
Contributor Covenant
REUSE status
npm Package Version
Coverage Status
설명 (Description)
UI5 Model Context Protocol 서버는 에이전트형 AI 도구(agentic AI tools)를 사용할 때 개발자 경험을 향상시키는 도구를 제공합니다.
주요 기능 (Key Features)
- 에이전트형 AI 도구와 작업할 때 새로운 UI5 프로젝트 생성에 도움을 줍니다.
- 개발자가 코드에서 UI5 전용 오류를 감지하고 수정하도록 지원합니다.
- 에이전트형 AI 도구를 위해 추가적인 UI5 전용 정보를 제공합니다.
[!TIP]
SAP Community의 공지 블로그 게시물도 확인해 보세요!
create_integration_card: 새로운 UI Integration Card를 스캐폴딩(Scaffolds)합니다.
create_ui5_app: 일련의 템플릿을 기반으로 새로운 UI5 애플리케이션을 스캐폴딩합니다.
get_api_reference: UI5 API 문서를 가져와 형식화합니다.
get_guidelines: UI5 개발 모범 사례에 대한 접근을 제공합니다.
get_integration_cards_guidelines: UI Integration Cards 개발 모범 사례에 대한 접근을 제공합니다.
get_project_info: UI5 프로젝트에서 메타데이터와 구성을 추출합니다.
get_typescript_conversion_guidelines: UI5 애플리케이션 및 컨트롤을 JavaScript에서 TypeScript로 변환하는 가이드라인을 제공합니다.
get_version_info: UI5 프레임워크의 버전 정보를 검색합니다.
run_manifest_validation: Manifest를 UI5 Manifest 스키마와 비교하여 유효성을 검사합니다.
run_ui5_linter: @ui5/linter와 통합하여 UI5 코드의 문제를 분석하고 보고합니다.
요구 사항
- Node.js 버전 v20.17.0, v22.9.0 이상
- npm 버전 v8.0.0 이상
- VS Code (GitHub Copilot), Cline, Claude Code, Codex 또는 기타 MCP와 호환되는 클라이언트와 같은 MCP 클라이언트
설정
대부분의 클라이언트를 위한 표준 구성
이 구성은 대부분의 MCP 클라이언트에서 작동합니다:
{
"mcpServers": {
"@ui5/mcp-server": {
...
<details>
<summary><i>네이티브 Windows용 특별 구성</i></summary>
네이티브 Windows 환경(WSL 아님)에서는 `npx` 앞에 `cmd /c`를 붙여야 할 수 있습니다:
{
"mcpServers": {
"@ui5/mcp-server": {
...
</details>
특정 MCP 클라이언트
위에 설명된 일반적인 구성을 제외하고, 일부 MCP 클라이언트는 MCP 서버를 설치하기 위한 단축 기능을 제공합니다. 아래에는 몇 가지 인기 있는 클라이언트에 대한 지침이 나와 있지만, 더 자세한 내용은 사용 중인 클라이언트의 문서를 참조할 수도 있습니다.
VS Code
권장: **GitHub MCP server registry**에서 설치하세요.
대안으로 VS Code CLI를 사용할 수 있습니다:
code --add-mcp '{"name":"@ui5/mcp-server","type": "stdio","command":"npx","args":["-y", "@ui5/mcp-server"]}'
Cline
- VSCode에서 Cline 패널을 엽니다.
- 상단에 있는 '플러스' 기호 옆의 "MCP Servers" 아이콘을 클릭합니다.
- "Configure" 탭으로 전환한 다음, "Configure MCP servers"를 클릭합니다.
- 열리는 편집기에서 위의 대부분의 클라이언트를 위한 표준 구성을 삽입합니다.
자세한 내용은 docs.cline.bot/mcp/adding-and-configuring-servers를 참조하세요.
Claude Code
claude mcp add --transport stdio --scope user ui5-mcp-server -- npx -y @ui5/mcp-server
Codex
codex mcp add --transport stdio ui5-mcp-server -- npx -y @ui5/mcp-server
프로젝트에 규칙 추가하기
다음 규칙들은 대규모 언어 모델(LLMs)이 UI5 MCP 서버를 올바르게 사용하는 데 지침을 제공합니다. 이 규칙들을 기존의 전역 또는 프로젝트별 AGENTS.md 파일에 추가하세요. 정확한 위치는 MCP 클라이언트에 따라 다를 수 있습니다. 예를 들어, Claude Code는 AGENTS.md 대신 CLAUDE.md 파일을 사용합니다.
## UI5용 지침(Guidelines)
UI5 MCP 서버의 `get_guidelines` 도구를 사용하여 최신 코딩 표준 및 UI5 개발 모범 사례를 검색하세요.
구성(Configuration)
UI5 MCP 서버는 다음 환경 변수를 사용하여 구성할 수 있습니다. 명령줄 인수는 받지 않습니다.
구성 옵션:
UI5_MCP_SERVER_ALLOWED_DOMAINS:
- 기본값:
localhost, services.odata.org
- 설명: 다양한 도구에서 사용이 허용되는 도메인 목록(쉼표로 구분)입니다. 예시:
localhost, example.com, sub.example.com. 모든 도메인을 허용하려면 빈 문자열로 설정하세요.
와일드카드 서브도메인의 경우, 해당 도메인 앞에 점을 붙이세요: .example.com. 이는 www.example.com과 일치하지만 example.com과는 일치하지 않습니다.
UI5_MCP_SERVER_RESPONSE_NO_STRUCTURED_CONTENT:
- 설명: 이 값을 설정하면 MCP 서버 응답에서 구조화된 콘텐츠(structured content)가 비활성화됩니다.
UI5_MCP_SERVER_RESPONSE_NO_RESOURCES:
UI5_MCP_SERVER_CDN_URL:
- 기본값: OpenUI5의 경우
https://sdk.openui5.org, SAPUI5의 경우 https://ui5.sap.com
- 설명: CDN에서 UI5 리소스를 가져오는 데 사용되는 기본 URL을 재정의합니다. 예시:
https://example.com. 이 값을 설정하면 OpenUI5와 SAPUI5 리소스 모두에 이 URL이 사용됩니다. 값은 유효한 URL이어야 합니다.
프로젝트 버전이 자동으로 URL에 추가된다는 점에 유의하십시오. 이는 런타임 시 URL이 다음과 같이 보일 수 있음을 의미합니다: https://example.com/1.120.0/resources/[...].
UI5_LOG_LVL:
- 기본값:
info
- 설명: 내부 로그 레벨:
silent, error, warn, info, perf, verbose, silly
UI5_DATA_DIR:
- 기본값: 사용자의 홈 디렉터리에 있는
.ui5 디렉터리
- 설명: MCP 서버가 캐시된 API 참조와 같은 데이터를 저장하는 디렉터리.
지원, 피드백 및 기여 (Support, Feedback, Contributing)
이 프로젝트는 GitHub 이슈를 통해 기능 요청/제안, 버그 보고 등 모든 것에 열려 있습니다. 기여와 피드백은 장려되며 언제나 환영받습니다. 어떻게 기여할 수 있는지, 프로젝트 구조 및 추가적인 기여 정보에 대한 자세한 내용은 기여 가이드라인을 참조하십시오.
또한 OpenUI5 커뮤니티 Slack의 #tooling 채널에서 채팅할 수 있습니다. 공개 Q&A를 위해서는 Stack Overflow에서 [ui5-tooling 태그]를 사용하십시오(https://stackoverflow.com/questions/tagged/ui5-tooling).
보안 / 공개 (Security / Disclosure)
보안 문제가 될 수 있는 버그를 발견한 경우, 보안 정책에 명시된 지침에 따라 보고해 주십시오. 보안 관련 의문점이나 문제는 GitHub 이슈로 생성하지 마십시오.
행동 강령 (Code of Conduct)
회원, 기여자 및 리더로서 우리는 커뮤니티 참여가 모든 사람에게 괴롭힘 없는 경험이 되도록 할 것을 약속합니다. 이 프로젝트에 참여함으로써 귀하는 항상 행동 강령을 준수하는 데 동의합니다.
라이선싱 (Licensing)
Copyright 2026 SAP SE 또는 SAP 계열사 및 UI5 MCP 서버 기여자들. 저작권 및 라이선스 정보는 LICENSE를 참조하십시오. 제3자 구성 요소와 해당 라이선스/저작권 정보를 포함한 상세 정보는 REUSE 도구를 통해 이용 가능합니다.