Skip to content

Complete PHP MCP client and Docker Compose stdio bridge - #1

Merged
Llewellynvdm merged 13 commits into
mainfrom
feature/standalone-php-client
Sep 24, 2026
Merged

Llewellynvdm merged 13 commits into
mainfrom
feature/standalone-php-client

Conversation

@Llewellynvdm

@Llewellynvdm Llewellynvdm commented Sep 18, 2026 •

Copy link
Copy Markdown
Contributor

Why

Let an AI application connect to an installed Joomla MCP component using only its HTTPS site URL and native Joomla API token, without copying Joomla/JCB business logic into the client.

Implemented

  • Standalone joomengine/mcp-client SDK and joomengine-mcp stdio executable.
  • Dockerfile/Compose launcher with locked dependencies, non-root/read-only execution, URL/token environment configuration and documented private-CA support.
  • Generic server-discovered tools, resources, prompts and job responses; bounded concurrent HTTPS, JSON-RPC IDs, pagination, finite SSE, cancellation, sessions and clean shutdown.
  • Private named-site credential storage, path/link/ownership checks, atomic updates and no automatic retry of ambiguous writes.
  • Exact stdio byte bounds, including whitespace frames and EOF behavior.

Validation

All final-head checks pass on PHP 8.3 and 8.4:

Includes 25 bridge checks, nine Compose/TLS checks per image and 14 live installed assertions per PHP version. The component's full coordinated acceptance additionally verifies generic-client JCB compiler/package/jobs, partial-effect recovery and hash-verified artifact downloads.

See docs/DOCKER.md for the ready-to-use AI launcher configuration. Remote stdio retains the Joomla API user's ACL and cannot acquire local console authority.

Related component and console plugin. No merge, release publication, registry image publication or Packagist registration is performed.

@Llewellynvdm Llewellynvdm changed the title Establish standalone PHP MCP client and separate server ownership Establish standalone PHP MCP client with tested connection library and server-first handoff Sep 18, 2026
@Llewellynvdm Llewellynvdm changed the title Establish standalone PHP MCP client with tested connection library and server-first handoff Complete standalone PHP MCP client, remote stdio bridge and installed-server acceptance Sep 21, 2026
@Llewellynvdm Llewellynvdm changed the title Complete standalone PHP MCP client, remote stdio bridge and installed-server acceptance Complete PHP MCP client and Docker Compose stdio bridge Sep 24, 2026
@Llewellynvdm
Llewellynvdm marked this pull request as ready for review September 24, 2026 10:02
@Llewellynvdm
Llewellynvdm merged commit 8691e35 into main Sep 24, 2026
12 checks passed
@Llewellynvdm
Llewellynvdm deleted the feature/standalone-php-client branch September 24, 2026 10:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant