Joomla에 대한 STDIO Model Context Protocol (MCP) 서버, PHP에 작성.

** 빠른 사실**

• 켜기: 당신의 컴퓨터
• MCP 수송: STDIO
• 현지 AI 도구 (예 : Claude Code) : ✅ 예
• 호스팅 된 AI 도구 (예 : ChatGPT) : ❌ 없음

[!팁] 호스팅 AI 도구를 사용하여 사용할 수있는 MCP 서버를 찾고 있다면 MCP4j를 참조하십시오.

이것은 무엇입니까?

MCP (Model Context Protocol) 서버는 외부 소프트웨어와 상호 작용하는 대형 언어 모델 (LLM, 일컬어 “AI”)을 허용합니다.

이 MCP 서버는 Joomla 5 이상에 대한 MCP 프로토콜의 구현입니다. LLM과 Joomla 설치 사이에 앉아 LLM은 Joomla 설치와 상호 작용 할 수 있습니다. 궁극적 인 목표는 Joomla에게 LLMs의 일류 시민을 만들고 LLMs를 사용하여 Joomla 사이트를 구축하고 관리 할 수 있도록 어떤 코드를 작성하거나 수동 단계를 수행하지 않고.

MCP 서버는 핵심 Joomla 웹 서비스를 다룹니다, 또한 Akeeba 확장. 이 저장소는 Akeeba Ltd.에 의해 제휴 또는 승인되지 않습니다.

요구 사항

• PHP 8.1 이상; PHP 8.4 권장.
• 6.x를 포함하여 Joomla 5.2 이상 임명,
• 슈퍼 사용자 계정을위한 Joomla API 토큰.

MCP4Joomla

A STDIO Model Context Protocol (MCP) server for Joomla, written in PHP.

Quick facts

• Runs on: your computer
• MCP transport: STDIO
• Usable with local AI Tools (e.g. Claude Code): ✅ Yes
• Usable with hosted AI Tools (e.g. ChatGPT): ❌ No

[!TIP] If you’re looking for an MCP server which can be used with hosted AI tools, please see MCP4j.

What is this?

An MCP (Model Context Protocol) server allows a large language model (LLM, also known as “AI”) to interact with external software.

This MCP server is an implementation of the MCP protocol for Joomla 5 and later. It sits between your LLM and your Joomla installation, allowing the LLM to interact with your Joomla installation. The ultimate goal is to make Joomla a first-class citizen in LLMs, allowing you to build and manage your Joomla sites using LLMs without having to write any code or take any manual steps.

The MCP server covers the core Joomla web services, but also some Akeeba extensions. This repository is not affiliated with or endorsed by Akeeba Ltd.

Requirements

• PHP 8.1 or later; PHP 8.4 recommended.
• A Joomla 5.2 or later installation, including 6.x
• A Joomla API token for a Super User account.

Usage

Clone this repository.

Go into the repository and run composer install to install the dependencies.

Edit your MCP configuration file and add this MCP server (the object you see under the MCP4Joomla key in the sample MCP config file below):

{
	"mcpServers": {
		"MCP4Joomla": {
			"command": "/usr/bin/php",
			"args": [
				"/path/to/joomla-mcp-php/mcp4joomla.php",
                "server"
			],
			"env": {
				"JOOMLA_BASE_URL": "https://www.example.com",
				"BEARER_TOKEN": "your_joomla_api_token"
			}
		}
	}
}

Where:

• /usr/bin/php is the path to your PHP CLI executable.
• /path/to/joomla-mcp-php/mcp4joomla.php is the path to the mcp4joomla.php file.
• https://www.example.com is the base URL of your Joomla installation, without the trailing /api, without the trailing /index.php.
• your_joomla_api_token is the Joomla API token for any active Super User account of your Joomla installation, something that looks like c2hhMjU2OjI5NDoxNmI5NzU3NWY1YTFhYTBmYWViNjUyMTRlZThmYzc1NTBiYWNkNmM4MjQ5N2ExYzllM2FjY2I5ODYxZjMxOGMx.

Using with Claude Code

You can add MCP4Joomla to Claude Code using the claude mcp add command.

[!IMPORTANT] MCP4Joomla provides 249 tools across 22 categories. Claude Code cannot handle this many tools reliably — it will only see a subset of them. You should always use --categories to limit the server to only the categories you need for your session. Use php mcp4joomla.php list-tools to see available categories.

For example, to work with content articles and contacts: