com_mcps服务器
一个Joomla 4、5和6组件，它公开了一个 模型上下文协议（MCP） 服务器通过HTTP上的JSON-RPC。它允许AI客户端（例如Claude Desktop、Cursor）与Joomla网站的内容和API进行交互。
版本： 0.4.0 · 要求： Joomla 5.x·PHP 8.1+
______________________________________________________________________
特性
- JSON-RPC 2.0端点可在站点和管理员上下文中访问
- 带有可选IP允许列表和CORS源控制的承载令牌身份验证
- 可配置的速率限制（每个时间窗口的请求）
- 通过Joomla的缓存层进行响应缓存
- 工具输入的JSON模式验证
- 用于监测的健康/活性端点
- Node.js标准→HTTP网桥(
mcp-http-bridge.js)适用于桌面MCP客户端
______________________________________________________________________
安装
来自拉链包装
- 跑
./build.sh在下面生成可安装的zipbuild/. - Joomla管理员→ 系统→ 安装→ 扩展，上传zip。
来源（开发）
- 将此存储库克隆到您的Joomla安装中
components/com_mcpserver目录（或符号链接）。 - 安装Composer依赖项：
cd admin
composer install --no-dev- 使用根目录的清单通过Joomla安装程序安装组件，或手动复制文件并在数据库中注册组件。
______________________________________________________________________
配置
导航到 管理员→ 组件→ MCP服务器→ 选项.
基本
| 设置 | 默认值 | 说明 |
|---|---|---|
| 服务器名称 | joomla-mcp-server | MCP服务器信息中返回的标识符 |
| 基本URL | *（空）* | Joomla REST API的基本URL |
| API代币 | *（空）* | 出站REST API调用的承载令牌 |
| 验证SSL | 是 | 验证出站请求上的SSL证书 |
| 默认语言 | * | 内容请求的语言标签 |
| 缓存TTL | 60 | 响应缓存生存期（秒） |
| WebSocket主机 | 0.0.0.0 | WebSocket侦听器的主机 |
| WebSocket端口 | 9077 | WebSocket侦听器的端口 |
安全
| 设置 | 默认值 | 说明 |
|---|---|---|
| 需要认证 | 是 | 对入站MCP请求强制使用承载令牌 |
| MCP承载令牌 | *（空）* | 客户端必须提供的令牌 Authorization: Bearer |
| IP允许列表 | *（空）* | 换行符分隔的允许客户端IP列表（空=全部） |
| 允许的起源 | *（空）* | 换行符分隔CORS源（空=全部） |
| 可信代理 | *（空）* | Newline分离的代理IP X-Forwarded-For 信任 |
| 费率限制请求 | 60 | 每个窗口允许的最大请求数 |
| 速率限制窗口 | 60 | 窗口持续时间（秒） |
______________________________________________________________________
端点
| 方法 | 路径 | 描述 |
|---|---|---|
POST | /index.php?option=com_mcpserver&task=rpc.execute | JSON-RPC 2.0 MCP端点（站点） |
GET | /index.php?option=com_mcpserver&task=health.check | 健康检查（现场） |
POST | /administrator/index.php?option=com_mcpserver&task=rpc.execute | JSON-RPC 2.0 MCP端点（管理员） |
GET | /administrator/index.php?option=com_mcpserver&task=health.check | 健康检查（管理员） |
______________________________________________________________________
桌面客户端集成（stdio桥）
对于通过stdio进行通信的客户端（例如Claude Desktop），请使用附带的Node.js网桥：
node site/mcp-http-bridge.js配置您的MCP客户端以生成此进程。网桥将stdio JSON-RPC消息转发到HTTP端点，并将响应流式传输回来。
______________________________________________________________________
依赖项
通过Composer进行管理 admin/:
| 包装 | 用途 |
|---|---|
guzzlehttp/guzzle | 出站HTTP客户端 |
monolog/monolog | 日志记录 |
justinrainbow/json-schema | JSON模式验证 |
______________________________________________________________________
许可证
GPL-2.0或更高版本