contentstack-mcp

Contentstack MCP 서버

이 모델 컨텍스트 프로토콜(MCP) 서버는 Contentstack의 콘텐츠 관리 API와 통합되어 Claude와 같은 AI 어시스턴트가 표준화된 프로토콜을 통해 Contentstack CMS와 상호 작용할 수 있도록 합니다.

참고: 이는 Contentstack MCP 서버의 초기 버전입니다. 향후 개선 사항 및 예정된 기능은 로드맵을 참조하세요.

목차

• 특징
• 설치
• 개발
• 구성
• AI 어시스턴트와의 통합
• 사용 예
• 로드맵
• 특허

특징

사용 가능한 리소스

• content-types : 모든 콘텐츠 유형을 나열합니다(URI: contentstack://content-types )
• content-type : UID로 콘텐츠 유형을 가져옵니다(URI: contentstack://content-type/{uid} )
• entries : 콘텐츠 유형별로 항목 가져오기(URI: contentstack://entries/{content_type_uid} )
• entry : 특정 항목 가져오기(URI: contentstack://entry/{content_type_uid}/{entry_uid} )
• assets : 모든 자산을 나열합니다(URI: contentstack://assets )

콘텐츠 유형 관리

• 콘텐츠 유형을 만들고, 업데이트하고, 삭제합니다.
• 스키마, 옵션, 필드 규칙 및 분류법 정의
• 글로벌 필드 관리

출입 관리

• 항목 생성, 업데이트 및 삭제
• 환경 전반에 걸쳐 항목 게시 및 게시 취소
• 필터링, 페이지 매김 및 정렬 옵션이 있는 쿼리 항목

글로벌 현장 관리

• 콘텐츠 유형 전반에 걸쳐 재사용을 위한 글로벌 필드를 만들고 업데이트합니다.
• 페이지 매김 옵션을 사용하여 글로벌 필드 검색

콘텐츠 워크플로

• 가이드형 콘텐츠 생성 워크플로
• 콘텐츠 분석 및 통찰력
• 이민 계획 지원

설치

필수 조건

• Node.js(v16.0.0 이상)
• Contentstack 계정
• API 자격 증명(API 키 및 관리 토큰)

NPM 설치

이 MCP 서버를 사용하는 가장 쉬운 방법은 NPM을 사용하는 것입니다.

지엑스피1

수동 설치

1. 저장소를 복제합니다.
   git clone https://github.com/darekrossman/contentstack-mcp.git cd contentstack-mcp
2. 종속성 설치:
   npm install
3. 환경 변수 설정:
   cp .env.example .env
   Contentstack 자격 증명으로 .env 파일을 편집합니다.
   CONTENTSTACK_API_KEY=your_api_key_here CONTENTSTACK_MANAGEMENT_TOKEN=your_management_token_here # Optional: Specify branch if using branches CONTENTSTACK_BRANCH=your_branch_name
4. 서버를 빌드하고 시작합니다.
   npm run build npm start

Smithery CLI를 통한 설치

Smithery CLI를 사용하여 이 MCP 서버를 설치할 수도 있습니다.

자세한 내용과 고급 사용법은 Smithery CLI 설명서를 참조하세요.

개발

개발을 위한 설정

개발을 위해 다음을 사용할 수 있습니다.

이렇게 하면 개발 주기를 더 빠르게 하기 위해 ts-node 사용하여 서버가 시작됩니다.

코드 품질

이 프로젝트에서는 Biome.js를 사용하여 린팅 및 서식을 적용합니다. Biome.js는 일관된 코드 스타일을 제공하고 잠재적인 문제를 조기에 발견하는 데 도움이 됩니다.

사용 가능한 명령

• 린트 코드 :
  npm run lint
• 린트 및 수정 :
  npm run lint:fix
• 형식 코드 :
  npm run format
• 형식 및 수정 :
  npm run format:fix

구성

입증

이 서버는 Contentstack의 API를 통한 인증이 필요합니다.

관리 토큰(필수) :

• 미리 정의된 권한이 있는 스택 수준 토큰
• CONTENTSTACK_MANAGEMENT_TOKEN 환경 변수를 통해 설정됨
• Contentstack 대시보드에서 생성: 설정 > 토큰 > 관리 토큰

API 키(필수) :

• 인증을 위한 스택 API 키
• CONTENTSTACK_API_KEY 환경 변수를 통해 설정됨

지점 지원

Contentstack 계정에서 브랜치를 사용하는 경우 다음과 같이 브랜치를 지정할 수 있습니다.

AI 어시스턴트와의 통합

데스크톱용 클로드

Claude for Desktop과 함께 이 서버를 사용하려면:

1. Claude for Desktop 구성 파일을 편집하세요.
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. mcpServers 섹션에 이 서버를 추가합니다.
   { "mcpServers": { "contentstack": { "command": "npx", "args": ["-y", "@drossman/contentstack-mcp"], "env": { "CONTENTSTACK_API_KEY": "your_api_key_here", "CONTENTSTACK_MANAGEMENT_TOKEN": "your_management_token_here" } } } }
3. 데스크톱용 Claude를 다시 시작하세요

커서

이 서버를 Cursor와 함께 사용하려면 Contentstack MCP 서버 구성을 추가하세요.

Smithery로 설치

선택한 클라이언트를 사용하여 Smithery CLI를 사용하여 이 MCP 서버를 설치할 수도 있습니다.

이용 가능한 클라이언트는 다음과 같습니다.

• 클로드
• 클라인
• 윈드서핑
• 루코드
• 재치있는
• 엔콘보
• 커서
• vs코드
• vscode-인사이더
• 볼타이
• 아마존-베드록
• 아마존큐

자세한 내용과 고급 사용법은 Smithery CLI 설명서를 참조하세요.

로드맵

• [ ] 향상된 AI 상황 이해 : 복잡한 쿼리에 대한 컨텍스트 프로비저닝 개선
• [ ] 고급 쿼리 및 필터링 : 여러 기준 및 사용자 정의 필드로 필터링 지원
• [ ] 워크플로 및 게시 자동화 : AI 기반 콘텐츠 워크플로 작업 활성화
• [ ] 자산 관리 향상 : 직접 자산 조작 기능 추가
• [ ] 대량 작업 지원 : 항목 및 자산에 대한 일괄 작업 구현
• [ ] 향상된 오류 처리 및 AI 피드백 : AI 사용을 위한 오류 메시지 개선
• [ ] 사용자별 컨텍스트 및 권한 : 사용자 권한에 따라 작업 맞춤화
• [ ] 사용자 정의 도구에 대한 확장성 : 확장 프레임워크 생성
• [ ] 실시간 이벤트 처리 : 반응형 AI 동작에 대한 웹훅 지원 추가
• [ ] 포괄적인 문서화 : AI 상호 작용을 위한 자세한 가이드 개발

샤우트아웃

Ivo Toby 에게 특별히 감사드립니다. 이 프로젝트와 저자는 이 분야에서 그의 작업에서 많은 영감을 받았습니다.

특허

MIT

면책 조항: 이 프로젝트는 Contentstack과 제휴, 보증 또는 지원을 받지 않습니다. Contentstack API를 사용하도록 설계된 독립적인 오픈소스 프로젝트입니다.