Joomla MCP 서버

소개

Joomla MCP(Model Context Protocol) 서버는 Claude와 같은 AI 비서가 Joomla 웹 서비스 API를 통해 Joomla 웹사이트와 상호 작용할 수 있도록 지원합니다. 또한 AI 비서를 사용하여 기사를 관리할 수 있는 도구를 제공합니다.

특징

Joomla 웹사이트에서 모든 기사 검색
모든 콘텐츠 카테고리 나열
새로운 기사를 작성하세요
기사 상태 관리(게시됨, 게시되지 않음, 휴지통 또는 보관됨)
기사 삭제
기사 업데이트(소개 텍스트와 전체 텍스트 모두 필요, "더 읽기" 중단 포함)

요구 사항

파이썬 3.11+
웹 서비스 API 플러그인이 활성화된 Joomla 4.x 또는 5.x
인증을 위한 API Bearer 토큰

설치

Joomla API 토큰 생성

사용자 프로필 액세스: Joomla 관리자 인터페이스에 로그인하고 사용자 메뉴로 이동한 다음 관리를 선택합니다.
슈퍼 유저 편집: 슈퍼 유저 계정(또는 원하는 사용자)을 찾아 클릭하여 프로필을 편집합니다.
토큰 생성: Joomla API 토큰 탭으로 이동하여 생성 버튼을 클릭하고 표시된 토큰을 복사합니다.

프로젝트/서버를 로컬로 설치하세요

저장소를 복제합니다.

지엑스피1

가상 환경을 설정하고 uv (Python 종속성 관리자, uv 문서 참조)를 사용하여 종속성을 설치하세요. uv가 설치되어 있다면 다음을 실행하세요.

uv sync 

Claude 또는 기타 AI 보조 장치에 설치

클로드 데스크탑

claude_desktop_config.json 에 다음을 추가하세요:

{
  "mcpServers": {
    "Joomla Articles MCP": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_PROJECT}}",
        "run",
        "main.py"
      ],
      "env": {
        "JOOMLA_BASE_URL": "<your_joomla_website_url>",
        "BEARER_TOKEN": "<your_joomla_api_token>"
      }
    }
  }
}

{{PATH_TO_UV}} uv 경로로 바꾸고( which uv 실행하여 찾으세요) {{PATH_TO_PROJECT}} 프로젝트 디렉토리 경로로 바꾸세요(저장소 루트에서 pwd 실행하세요).

사용 가능한 도구

1. get_joomla_articles()

API를 통해 Joomla 웹사이트의 모든 기사를 검색합니다.

2. get_joomla_categories()

Joomla 웹사이트에서 모든 카테고리를 검색하여 읽을 수 있는 목록 형식으로 정리합니다.

3. create_article()

API를 통해 Joomla 웹사이트에 새로운 기사를 생성합니다.

매개변수:

article_text (필수): 기사의 내용(일반 텍스트 또는 HTML)
title (선택 사항): 기사 제목(제공되지 않으면 콘텐츠에서 추론)
category_id (선택 사항): 기사의 카테고리 ID
convert_plain_text (선택 사항, 기본값: True): 일반 텍스트를 HTML로 자동 변환합니다.
published (선택 사항, 기본값: True): 기사를 즉시 게시합니다.

4. 기사 상태 관리()

API를 통해 Joomla 웹사이트의 기존 기사 상태를 관리합니다.

매개변수:

article_id (필수): 확인하고 업데이트할 기존 기사의 ID
target_state (필수): 기사의 원하는 상태(1=게시됨, 0=게시되지 않음, 2=보관됨, -2=휴지됨)

5. 삭제_기사()

API를 통해 Joomla 웹사이트에서 기사를 삭제합니다.

매개변수:

article_id (필수): 삭제할 기사의 ID

6. 업데이트_기사()

Joomla 웹사이트의 기존 기사를 API를 통해 업데이트합니다. Joomla의 기사 구조(티저용 소개 텍스트, "더 보기" 이후의 콘텐츠용 전체 텍스트)에 맞춰 introtext 와 fulltext 모두 필요합니다.

매개변수:

article_id (필수): 업데이트할 기사의 ID
title (선택 사항): 기사의 새 제목
introtext (필수): 기사의 소개 텍스트(일반 텍스트 또는 HTML)
fulltext (필수): 기사의 전체 내용(일반 텍스트 또는 HTML)
metadesc (선택 사항): 기사에 대한 메타 설명

보안 고려 사항

Joomla API 토큰은 귀하의 사이트에 접근할 수 있습니다. 비밀번호를 다루는 것처럼 다루세요.
서버는 XSS 공격을 방지하기 위해 HTML 콘텐츠를 정리합니다.
Joomla 웹사이트가 HTTPS를 사용하여 API 통신을 보호하는지 확인하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

Joomla MCP Server

Integrations