Repository navigation
Conversation
…red external audience
…er at the site's root, and is reported as a mistake
…ther spelling of the tenant acme
…hole path before CakePHP 5.3.7
…offset, and otherwise passes on the registry's own cursor
…_PROXY decides nothing else, and socks5h is the SOCKS scheme
… setting, is logged and fails mcp check
… slow authorization server holds a worker that long at most
…the mark, a new grant ends the old one's refresh, and two first saves both succeed
…gn-in already asked for marks nothing, so there is no redirect loop
…er and the catalog share one container bridge
…t apps get different tools
…wercase, so ACME never shares acme's resource
…it was opened with
…ndpoint isEndpoint() does not see
…a timeout: curl's whole seconds are rounded up
…s the proxy, 127.0.0.2 included
…e digit strings env() gives
…wd, not a name env looks up in PATH
…ge, as the first sign-in does not
… and the server speak
…ept like the lists, by their hints and credential
…rget, instead of an empty answer
…ult that does not fit says its tool ran, and the search reads allowed values and nested arguments
…gment that is not there, any order, the shape of keys, and a closure at a path
…s keys, and any-order lists match item by item
…d at another server gets nothing the previous one answered
…ted as the digit strings env() gives
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Version 2.2.0. A 2.1 application keeps working without config or code changes. A few behaviour changes can still be noticed, all listed at the top of
CHANGELOG.md(among them: the registry is loaded before authentication,initializeannounces exactly what the server has,mcpCallTool()sends a progress token,McpConfig::isEndpoint()reads the path as the router does). Every new feature is off until configured.What is new
Servers
Mcp.servers), each with its own route, metadata route, tools, auth and authorizer. Security sections are replaced whole (withmodeandauthorizerrequired),identityis never inherited, an inheritedauthgets the server's own resource, the rest is inherited key by key. A mistake in one entry stops that entry only, is logged, andmcp checkreports it./mcp/t/{tenant}): one config and one set of tools for every value, the value available to tools throughMcpRoute; in OAuth modes each value is its own resource, so a token for one value is refused for another.'route' => false).Mcp.server.cache), always private on a per-usertools/list.Mcp.schema.normalizefor hosts that reject type arrays;Mcp.server.icons.Mcp-*header with invalid UTF-8 answers 400.Tools, resources and prompts
Mcp.catalog): chosen tools leavetools/listand are reached throughfind_toolsandcall_tools. Every inner call goes through the authorizer, the tool scopes, the input schema and the audit log (via=call_tools), like a directtools/call.ResourceAuthorizerInterfaceandPromptAuthorizerInterface. Denied elements are hidden from the lists and answer like unknown ones on read, get, subscribe, unsubscribe and completion, and asubscriptions/listenstream carries no update for them; a denied template denies the URIs it serves.RbacToolAuthorizersupports them only once a rule names them, so 2.1 rule sets change nothing.#[McpWhen]: register a tool, resource, template or prompt only when a config value is on or a callback returns true.ToolValidation::check()andcheckPrompt()with a CakeValidator;ToolError::message().mcp_tool,mcp_resource,mcp_promptandmcp_app, each with its test.MCP Apps (
Mcp.apps.enabled)AppView::render()renders an app page from a Cake template, in a layout that inlines the official MCP Apps client (@modelcontextprotocol/ext-apps2.0.4, vendored with its license inresources/ext-apps).#[McpApp]links a tool to its app. App-only tools are left out oftools/listfor clients that do not render apps, and tools with an app never go behind the catalog. They still go through the authorizer, scopes and audit (app=1).MCP client (
Mcp.clients)McpClients::get('name')calls tools, resources and prompts of other MCP servers, over HTTP (token, callable token or headers) or a local stdio server, withtools.only/tools.except,ping(),serverInfo(),capabilities(),instructions(), list limits, one retry when the server refused the call before running it (an expired session, a header mismatch, a 401 answered with a fresh token), and an optional list cache that follows the server's cache hints and keys private lists by the credential they were asked with.'auth' => 'user'): each user connects their own account through OAuth (RFC 9728 and 8414 discovery, Client ID Metadata Document on a site authorization servers can reach, otherwise dynamic registration, PKCE, resource indicators,isscheck, scope step-up). Tokens are stored encrypted in tables keyed by SHA-256 hashes, refreshed by one request at a time per user, and revoked ondisconnect(). A configuredclientSecretis bound to itsissuer. Ships one migration (mcp_client_connections,mcp_client_registrations).'auth' => 'client_credentials'.Mcp.client.proxyand a per-clientallowPrivateNetworkfor corporate networks.Testing
McpTestTrait: tools that report progress get a response in tests; prompts, resources and completions through the server (mcpGetPrompt(),mcpReadResource(),mcpComplete(), lists); assertions for notifications, structured content, what another identity sees, andmcpUseServer().bin/cake mcp checkDiscovery,Tool schemas,Cache hints,Conditions,Catalog,Apps,Clients, one per named server, and checks across servers (shared routes, resources or audiences, nested scan directories, route parameters missing from a resource).Docs
docs/features.md(overview),docs/resources-and-prompts.md,docs/apps.md,docs/mcp-client.md.docs/tools.md,docs/configuration.md,docs/authorization.mdanddocs/testing.mdcover the rest.CHANGELOG.mdhas the full list.Upgrading
composer update. Runbin/cake migrations migrate -p CakeDC/Mcponly if you use the MCP client in user orclient_credentialsmode.Checks
CHANGELOG.md). The migration was run up, down and up again on SQLite, MySQL 8.4, MariaDB 11.8 and PostgreSQL 17.Known limits (left on purpose)
invalid_client, the stored registration is dropped, and both users connect again. With a public client, which is what the plugin asks for, nothing happens./mcp%2Fadmincounts as an endpoint before routing and is then not served (the safe direction), and two tests of the suite fail. Composer refuses those releases by default because of security advisories; the patched 5.1.10, 5.2.15 and 5.3.7 behave as expected.Where to look first
src/Catalog/ToolCatalog.php(inner calls),src/Authorization/(resource and prompt authorization),src/McpConfig.php(inheritance between servers, route parameters),src/Client/Http/(SSRF guard),src/Client/OAuth/andsrc/Client/UserConnection.php(OAuth flow, refresh).src/Server/ServerFactory.phpfor how servers, the catalog and conditions are built.