Ghost MCP Server

고스트 MCP 서버

‼️ 중요 공지: Python에서 TypeScript로 마이그레이션

이번 v0.1.0 릴리스에서는 Ghost MCP Server를 Python에서 TypeScript로 완전히 다시 작성했습니다. 이 주요 변경 사항은 다음과 같은 여러 가지 이점을 제공합니다.

• 간소화된 설치: 이제 NPM 패키지로 사용 가능(@fanyangmeng/ghost-mcp)
• 향상된 안정성: 사용자 정의 구현 대신 공식 @tryghost/admin-api 클라이언트를 사용합니다.
• 더 나은 유지 관리성: TypeScript는 유형 안전성과 더 나은 코드 구성을 제공합니다.
• 간소화된 구성: 간단한 환경 변수 설정

주요 변경 사항

• Python 종속성은 더 이상 필요하지 않습니다.
• 구성 방법이 변경되었습니다(이제 Node.js 환경 변수를 사용함)
• Docker 배포가 간소화되었습니다.
• 다른 설치 프로세스(이제 NPM 사용)

Python 버전에서 마이그레이션하는 방법에 대한 자세한 내용은 아래 업데이트된 문서를 참조하세요. 문제가 발생하면 GitHub에 이슈를 남겨주세요.

Claude와 같은 LLM 인터페이스를 통해 Ghost CMS와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 JWT 인증과 게시물, 사용자, 회원, 티어, 오퍼 및 뉴스레터를 관리하는 다양한 MCP 도구를 활용하여 Ghost 블로그에 안전하고 포괄적인 액세스를 제공합니다.

특징

• @tryghost/admin-api 사용하여 Ghost Admin API 요청을 보호합니다.
• 게시물, 사용자, 회원, 계층, 제안 및 뉴스레터를 포함한 포괄적인 엔터티 액세스
• 퍼지 및 정확한 일치 옵션을 모두 갖춘 고급 검색 기능
• Ghost 엔터티에 대한 자세하고 사람이 읽을 수 있는 출력
• 사용자 정의 GhostError 예외를 사용한 강력한 오류 처리
• 향상된 문제 해결을 위한 MCP 컨텍스트를 통한 통합 로깅 지원

용법

예를 들어 Claude Desktop과 같은 MCP 클라이언트에서 이를 사용하려면 claude_desktop_config.json 에 다음을 추가하세요.

지엑스피1

사용 가능한 리소스

다음 Ghost CMS 리소스는 이 MCP 서버를 통해 사용할 수 있습니다.

• 게시물 : Ghost 사이트에 게시된 기사와 콘텐츠입니다.
• 회원 : 귀하의 사이트에 등록된 사용자와 구독자입니다.
• 뉴스레터 : Ghost를 통해 관리 및 전송되는 이메일 뉴스레터입니다.
• 특가 : 회원을 위한 프로모션 및 할인 혜택.
• 초대장 : Ghost 사이트에 신규 사용자나 직원을 초대하는 메시지입니다.
• 역할 : Ghost 관리자 내의 사용자 역할 및 권한.
• 태그 : 게시물과 콘텐츠에 대한 조직적 태그입니다.
• 등급 : 회원을 위한 구독 등급 및 플랜입니다.
• 사용자 : 관리자 사용자 및 직원 계정.
• 웹후크 : 외부 서비스에 대한 자동 이벤트 알림.

사용 가능한 도구

이 MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 통해 Ghost CMS를 관리하기 위한 포괄적인 도구 세트를 제공합니다. 각 리소스는 일반적으로 엔티티 탐색, 읽기, 생성, 편집 및 삭제를 포함한 일련의 작업을 제공합니다. 사용 가능한 도구의 요약은 다음과 같습니다.

게시물

• 게시물 탐색 : 선택적 필터, 페이지 번호, 순서를 적용하여 게시물을 나열합니다.
• 게시물 읽기 : ID 또는 슬러그로 게시물을 검색합니다.
• 게시물 추가 : 제목, 내용, 상태를 입력하여 새 게시물을 만듭니다.
• 게시물 수정 : ID로 기존 게시물을 업데이트합니다.
• 게시물 삭제 : ID로 게시물을 삭제합니다.

회원들

• 회원 검색 : 필터와 페이지 매김을 통해 회원을 나열합니다.
• 회원 읽기 : ID 또는 이메일로 회원을 검색합니다.
• 회원 추가 : 새로운 회원을 만듭니다.
• 회원 편집 : 회원 세부 정보를 업데이트합니다.
• 회원 삭제 : 회원을 제거합니다.

뉴스레터

• 뉴스레터 찾아보기 : 뉴스레터 목록을 확인하세요.
• 뉴스레터 읽기 : ID로 뉴스레터를 검색합니다.
• 뉴스레터 추가 : 새로운 뉴스레터를 만듭니다.
• 뉴스레터 편집 : 뉴스레터 세부 정보를 업데이트합니다.
• 뉴스레터 삭제 : 뉴스레터를 제거합니다.

제안

• 상품 탐색 : 상품 목록을 확인하세요.
• 제안 읽기 : ID로 제안을 검색합니다.
• 제안 추가 : 새로운 제안을 만듭니다.
• 제안 편집 : 제안 세부 정보를 업데이트합니다.
• 제안 삭제 : 제안을 제거합니다.

초대합니다

• 초대장 찾아보기 : 초대장을 나열합니다.
• 초대 추가 : 새로운 초대장을 만듭니다.
• 초대 삭제 : 초대를 제거합니다.

역할

• 역할 찾아보기 : 역할 나열.
• 역할 읽기 : ID로 역할을 검색합니다.

태그

• 태그 탐색 : 태그 목록.
• 태그 읽기 : ID나 슬러그로 태그를 검색합니다.
• 태그 추가 : 새로운 태그를 만듭니다.
• 태그 편집 : 태그 세부 정보를 업데이트합니다.
• 태그 삭제 : 태그를 제거합니다.

계층

• 티어 찾아보기 : 티어 목록.
• 계층 읽기 : ID로 계층을 검색합니다.
• 계층 추가 : 새로운 계층을 만듭니다.
• 티어 편집 : 티어 세부 정보를 업데이트합니다.
• 티어 삭제 : 티어를 제거합니다.

사용자

• 사용자 찾아보기 : 사용자 목록을 표시합니다.
• 사용자 읽기 : ID나 슬러그로 사용자를 검색합니다.
• 사용자 편집 : 사용자 세부 정보를 업데이트합니다.
• 사용자 삭제 : 사용자를 제거합니다.

웹훅

• 웹훅 탐색 : 웹훅을 나열합니다.
• 웹훅 추가 : 새로운 웹훅을 만듭니다.
• 웹훅 삭제 : 웹훅을 제거합니다.

각 도구는 MCP 프로토콜을 통해 접근 가능하며 호환되는 클라이언트에서 호출할 수 있습니다. 자세한 매개변수 스키마 및 사용법은 src/tools/ 의 소스 코드를 참조하십시오.

오류 처리

Ghost MCP 서버는 API 통신 오류 및 처리 문제를 처리하기 위해 맞춤형 GhostError 예외를 사용합니다. 이를 통해 문제 해결에 도움이 되는 명확하고 설명적인 오류 메시지가 제공됩니다.

기여하다

1. 포크 저장소
2. 기능 브랜치 생성
3. 변경 사항 커밋
4. 풀 리퀘스트 생성

특허

MIT