Skip to main content
Glama

Joomla MCP 服务器

铁匠徽章

目录

Related MCP server: cms-mcp-hub

介绍

Joomla MCP(模型上下文协议)服务器使 Claude 等 AI 助手能够通过 Joomla Web 服务 API 与 Joomla 网站进行交互。它提供了使用 AI 助手管理文章的工具。

特征

  • 从 Joomla 网站检索所有文章

  • 列出所有内容类别

  • 创建新文章

  • 管理文章状态(已发布、未发布、已删除或已存档)

  • 删除文章

  • 更新文章(需要简介文本和全文,并带有“阅读更多”中断)

要求

  • Python 3.11+

  • 启用了 Web 服务 API 插件的 Joomla 4.x 或 5.x

  • 用于身份验证的 API Bearer 令牌

安装

创建 Joomla API 令牌

  1. 访问用户配置文件:登录 Joomla 管理员界面并导航到用户菜单,然后选择管理。

  2. 编辑超级用户:查找并单击超级用户帐户(或所需用户)以编辑其个人资料。

  3. 生成令牌:转到 Joomla API 令牌选项卡,单击生成按钮,然后复制显示的令牌。

本地安装项目/服务器

  1. 克隆存储库:


git clone https://github.com/nasoma/joomla-mcp-sever.git
cd joomla-mcp-server
  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. 获取 joomla_articles()

通过其 API 从 Joomla 网站检索所有文章。

2. 获取joomla类别

从 Joomla 网站检索所有类别并将其格式化为可读列表。

3. 创建文章()

通过其 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都需要与 Joomla 的文章结构保持一致(文章简介用于预告,全文用于“阅读更多”后的正文)。

参数:

  • article_id (必填):需要更新的文章的ID

  • title (可选):文章的新标题

  • introtext (必需):文章的介绍性文字(纯文本或 HTML)

  • fulltext (必填):文章的完整内容(纯文本或 HTML)

  • metadesc (可选):文章的元描述

安全注意事项

  • Joomla API 令牌可以访问您的网站。请像对待密码一样对待它。

  • 服务器清理 HTML 内容以防止 XSS 攻击

  • 确保您的 Joomla 网站使用 HTTPS 来保护 API 通信。

执照

该项目已获得 MIT 许可。

Available Tools

6 tools
create_articleC

Create a new article on the Joomla website.

Inputs: article_text (required), title, category_id, convert_plain_text, +1 more. Returns: result

get_joomla_articlesB

Retrieve all articles from the Joomla website.

Inputs: no named parameters. Returns: result

get_joomla_categoriesB

Retrieve all categories from the Joomla website.

Inputs: no named parameters. Returns: result

manage_article_stateC

Manage the state of an existing article on the Joomla website (published, unpublished, archived, trashed)

Inputs: article_id (required), target_state (required). Returns: result

move_article_to_trashA

Delete an article by moving to the trashed state on the Joomla website, allowing recovery.

Inputs: article_id (required), expected_title. Returns: result

update_articleC

Update an existing article on the Joomla website.

Inputs: article_id (required), title, introtext, fulltext, +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 6 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between 'manage_article_state' and 'move_article_to_trash' since moving to trash is a specific state change. The descriptions clarify this, but an agent might initially confuse them as both handle article states. Other tools like create, get, and update are clearly differentiated.

    Naming Consistency3/5

    The naming is mixed: some tools use verb_noun (e.g., create_article, update_article), while others include 'joomla' prefix (e.g., get_joomla_articles, get_joomla_categories) and one uses a different verb style (manage_article_state). This inconsistency reduces predictability, though the names remain readable and understandable.

    Tool Count5/5

    With 6 tools, the count is well-scoped for managing articles and categories in a Joomla context. Each tool serves a specific function, and there are no extraneous tools, making it appropriate for the server's purpose without being overwhelming or insufficient.

    Completeness4/5

    The tool set covers core CRUD operations for articles (create, get, update, delete via trash) and includes category retrieval, which is essential for Joomla content management. A minor gap exists in lacking direct category management tools (e.g., create or update categories), but agents can still perform basic workflows with the provided tools.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive MCP server for WordPress automation that enables users to manage content, themes, and site configurations using AI-driven workflows and the WordPress REST API. It provides a wide array of tools for site planning, management, and optimization compatible with tools like Cursor and Claude.
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A universal connector hub that proxies Claude.ai tool calls to any CMS that runs an MCP server, enabling natural language interactions with Drupal, Joomla, WordPress, and more through a single endpoint.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for WordPress content management that provides a secure interface for AI assistants to interact with WordPress sites, enabling content creation, editing, and media management without destructive operations.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for WordPress content management via REST API, supporting posts, pages, media, comments, and terms through natural language interfaces like Cursor, ChatGPT, Codex, and Claude.
      MIT