com_mcpserver

A Joomla 5 component that exposes a Model Context Protocol (MCP) server via JSON-RPC over HTTP. It allows AI clients (e.g. Claude Desktop, Cursor) to interact with your Joomla site's content and APIs.

Version: 0.4.0 · Requires: Joomla 5.x · PHP 8.1+

---

• JSON-RPC 2.0 endpoint accessible on both the site and administrator contexts
• Bearer token authentication with optional IP allow-listing and CORS origin control
• Configurable rate limiting (requests per time window)
• Response caching via Joomla's cache layer
• JSON Schema validation for tool inputs
• Health / liveness endpoint for monitoring
• Node.js stdio→HTTP bridge (mcp-http-bridge.js) for desktop MCP clients

---

1. Run ./build.sh to produce the installable zip under build/.
2. In Joomla Administrator → System → Install → Extensions, upload the zip.

1. Clone this repository into your Joomla installation's components/com_mcpserver directory (or symlink it).
2. Install Composer dependencies:

cd admin
composer install --no-dev

1. Install the component via the Joomla installer using the manifest at the root, or copy the files manually and register the component in the database.

---

Navigate to Administrator → Components → MCP Server → Options.

| Setting | Default | Description | |---|---|---| | Server Name | joomla-mcp-server | Identifier returned in MCP server info | | Base URL | *(empty)* | Base URL of the Joomla REST API | | API Token | *(empty)* | Bearer token for outbound REST API calls | | Verify SSL | Yes | Verify SSL certificates on outbound requests | | Default Language | * | Language tag for content requests | | Cache TTL | 60 | Response cache lifetime in seconds | | WebSocket Host | 0.0.0.0 | Host for the WebSocket listener | | WebSocket Port | 9077 | Port for the WebSocket listene