remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides secure and comprehensive access to Ghost CMS blogs, enabling management of posts, users, members, tiers, offers, and newsletters through LLM interfaces

고스트 MCP 서버

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

특징

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

설치

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 Ghost MCP Server를 자동으로 설치하려면:

지엑스피1

수동 설치

# Clone repository
git clone git@github.com/mfydev/ghost-mcp.git
cd ghost-mcp

# Create virtual environment and install
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

요구 사항

파이썬 ≥ 3.12
Admin API 액세스를 통해 Ghost 인스턴스 실행(v5.x+ 권장)
Node.js(MCP Inspector로 테스트용)

용법

환경 변수

GHOST_API_URL=https://yourblog.com  # Your Ghost Admin API URL
GHOST_STAFF_API_KEY=your_staff_api_key                 # Your Ghost Staff API key

MCP 클라이언트와 함께 사용

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

{
  "mcpServers": {
    "ghost": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/ghost-mcp",
        "run",
        "src/main.py"
      ],
      "env": {
        "GHOST_API_URL": "your_ghost_api_url",
        "GHOST_STAFF_API_KEY": "your_staff_api_key"
      }
    }
  }
}

MCP Inspector로 테스트

GHOST_API_URL=your_ghost_api_url GHOST_STAFF_API_KEY=your_staff_api_key npx @modelcontextprotocol/inspector uv --directory /path/to/ghost-mcp run src/main.py

사용 가능한 도구

Ghost MCP는 이제 모든 Ghost CMS 기능에 액세스할 수 있는 단일 통합 도구를 제공합니다.

주요 도구

ghost : 모든 Ghost CMS 기능에 액세스하기 위한 중앙 도구

고스트 도구 사용

고스트 도구는 두 가지 주요 매개변수를 허용합니다.

action : 수행할 특정 Ghost 작업
params : 지정된 작업에 대한 매개변수 사전

사용 예:

# List posts
ghost(action="list_posts", params={"format": "text", "page": 1, "limit": 15})

# Search posts by title
ghost(action="search_posts_by_title", params={"query": "Welcome", "exact": False})

# Create a post
ghost(action="create_post", params={
    "post_data": {
        "title": "New Post via MCP",
        "status": "draft",
        "lexical": "{\"root\":{\"children\":[{\"children\":[{\"detail\":0,\"format\":0,\"mode\":\"normal\",\"style\":\"\",\"text\":\"Hello World\",\"type\":\"text\",\"version\":1}],\"direction\":\"ltr\",\"format\":\"\",\"indent\":0,\"type\":\"paragraph\",\"version\":1}],\"direction\":\"ltr\",\"format\":\"\",\"indent\":0,\"type\":\"root\",\"version\":1}}"
    }
})

사용 가능한 작업

고스트 도구는 이전과 동일한 모든 작업을 지원하지만 이제는 통합된 인터페이스를 통해 지원합니다.

게시물 작업

list_posts : 페이지 번호가 있는 블로그 게시물 목록
search_posts_by_title : 제목으로 게시물 검색
read_post : 특정 게시물의 전체 내용을 검색합니다.
create_post : 새로운 게시물을 만듭니다
update_post : 특정 게시물 업데이트
delete_post : 특정 게시물 삭제
batchly_update_posts : 단일 요청으로 여러 게시물 업데이트

태그 작업

browse_tags : 모든 태그 나열
read_tag : 특정 태그 정보 검색
create_tag : 새로운 태그를 생성합니다
update_tag : 기존 태그를 업데이트합니다.
delete_tag : 특정 태그를 삭제합니다

사용자 작업

list_roles : 사용 가능한 모든 역할을 나열합니다.
create_invite : 새로운 사용자 초대장을 만듭니다.
list_users : 모든 사용자 나열
read_user : 특정 사용자의 세부 정보를 가져옵니다.
delete_user : 특정 사용자 삭제

회원 작업

list_members : 멤버 목록
read_member : 특정 멤버 정보를 검색합니다
create_member : 새로운 멤버를 생성합니다
update_member : 기존 멤버 업데이트

티어 액션

list_tiers : 모든 멤버십 등급을 나열합니다.
read_tier : 특정 계층 정보 검색
create_tier : 새로운 티어를 생성합니다
update_tier : 기존 티어 업데이트

제안 작업

list_offers : 프로모션 혜택 목록
read_offer : 특정 제안 정보를 가져옵니다
create_offer : 새로운 제안을 만듭니다
update_offer : 기존 제안을 업데이트합니다.

뉴스레터 작업

list_newsletters : 모든 뉴스레터 나열
read_newsletter : 특정 뉴스레터 정보 검색
create_newsletter : 새로운 뉴스레터를 만듭니다
update_newsletter : 기존 뉴스레터 업데이트

웹훅 동작

create_webhook : 새로운 웹훅을 생성합니다
update_webhook : 기존 웹훅을 업데이트합니다.
delete_webhook : 특정 웹훅을 삭제합니다.

사용 가능한 리소스

모든 리소스는 URI 패턴을 따릅니다: [type]://[id]

user://{user_id} : 사용자 프로필 및 역할
member://{member_id} : 회원 정보 및 구독
tier://{tier_id} : 계층 구성
offer://{offer_id} : 제안 세부 정보
newsletter://{newsletter_id} : 뉴스레터 설정
post://{post_id} : 게시물 내용 및 메타데이터
blog://info : 일반 블로그 정보

오류 처리

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

기여하다

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

특허

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

View all tools

LLM 인터페이스를 통해 Ghost CMS와 상호 작용할 수 있으며, JWT 인증을 통해 게시물, 사용자, 뉴스레터를 관리하고 자세한 출력과 오류 처리를 통해 안전한 액세스를 제공합니다.

Related Resources

Reddit Discussion about this server

Appeared in Searches

Information about ghosts