medienreaktor / neos-mcp

0.1.1 2026-11-10 08:56 UTC

Requires

• php: ^8.4
• guzzlehttp/psr7: ^2.4
• medienreaktor/neos-api: ^2.0
• medienreaktor/neos-oauth: ^0.1
• medienreaktor/neos-openapi-mcp: ^0.1
• neos/flow: ^9.0
• neos/openapi-flowadapter: *

MIT

Published on Packagist.org on 2026-11-10 08:57 UTC

README

An MCP server for Neos on /mcp: every operation of the Neos API (Neos.Api) is a tool, built by medienreaktor/neos-openapi-mcp. It speaks MCP 2026-07-28 (stateless Streamable HTTP).

Usage

Install the package next to Neos.Api and Neos.OAuth, then add the server to a client, e.g. Claude Code:

claude mcp add --transport http neos https://example.com/mcp

The client logs in through Neos.OAuth with a client ID metadata document or dynamic client registration (both disabled by default, see Neos.OAuth.clientIdMetadataDocuments and dynamicClientRegistration). Tokens must be bound to /mcp (RFC 8707). A tool runs as the token's account: it is only listed if the token's scopes and the account's privileges allow it, as over the API.

The server is configured in Neos.Mcp.servers.neos, see Configuration/Settings.yaml. Other hosts than the OAuth issuer's go into allowedHosts.

License

MIT, see LICENSE.