Joomla MCP

Name: Joomla MCP
Author: nasoma

@nasoma

Joomla MCP について

The Joomla MCP Server facilitates interaction between AI assistants (like Claude) and Joomla websites through the Joomla Web Services API. It provides tools to manage articles, including retrieving, creating, updating, and deleting content, as well as managing article states.

#joomla #mcp #ai-assistant

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

nasoma

投稿者

Ana Guy

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "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>"
      }
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Joomla MCP?

Joomla MCP is a Model Context Protocol server that lets AI assistants like Claude interact with Joomla websites via the Joomla Web Services API, primarily to manage articles.

How to use Joomla MCP?

Install Python 3.11+, clone the repository, set up a virtual environment with uv, and configure the server in your AI assistant (e.g., Claude Desktop) by providing the Joomla base URL and a bearer token in environment variables.

Key features of Joomla MCP

Retrieve all articles from a Joomla website
List all content categories
Create new articles with optional plain-text-to-HTML conversion
Manage article states (published, unpublished, trashed, archived)
Delete articles
Update articles (requires both introtext and fulltext with a "Read more" break)

Use cases of Joomla MCP

Manage Joomla articles through conversational AI commands
Automate content creation and publishing workflows
Bulk update or delete articles without manual intervention
Integrate Joomla content management with AI-powered assistants

FAQ from Joomla MCP

What are the requirements for using Joomla MCP?

Python 3.11+, a Joomla 4.x or 5.x site with the Web Services API plugin enabled, and a valid API bearer token.

How do I obtain a Joomla API token?

Log in to the Joomla Administrator, go to Users > Manage, edit the Super User account, open the "Joomla API Token" tab, click Generate, and copy the token.

What tools does Joomla MCP provide?

Six tools: get_joomla_articles(), get_joomla_categories(), create_article(), manage_article_state(), delete_article(), and update_article().

How do I configure Joomla MCP for Claude Desktop?

Add an entry to claude_desktop_config.json with the path to uv, the project directory, and the environment variables JOOMLA_BASE_URL and BEARER_TOKEN.

Are there security considerations?

Treat the API token like a password, as it provides site access. The server sanitizes HTML to prevent XSS, and HTTPS should be used for API communications.