Joomla MCP 服务器

介绍

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

特征

从 Joomla 网站检索所有文章
列出所有内容类别
创建新文章
管理文章状态（已发布、未发布、已删除或已存档）
删除文章
更新文章（需要简介文本和全文，并带有“阅读更多”中断）

要求

Python 3.11+
启用了 Web 服务 API 插件的 Joomla 4.x 或 5.x
用于身份验证的 API Bearer 令牌

安装

创建 Joomla API 令牌

访问用户配置文件：登录 Joomla 管理员界面并导航到用户菜单，然后选择管理。
编辑超级用户：查找并单击超级用户帐户（或所需用户）以编辑其个人资料。
生成令牌：转到 Joomla API 令牌选项卡，单击生成按钮，然后复制显示的令牌。

本地安装项目/服务器

克隆存储库：

git clone https://github.com/nasoma/joomla-mcp-sever.git
cd joomla-mcp-server

设置虚拟环境并使用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 许可。

Joomla MCP Server