Joomla MCP 服务器

👁 铁匠徽章

目录

• 介绍

• 特征

• 要求

• 安装

• 可用工具

• 安全注意事项

Related MCP server: Azure MCP Server

介绍

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

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

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_articleC
• get_joomla_articlesB
• get_joomla_categoriesB
• manage_article_stateC
• move_article_to_trashA
• update_articleC