Slicing the SDK into Multiple Packages

Offen

#489 erstellt am 29.8.2026 3 Kommentare 3 Reaktionen 1 zugewiesene Person Auf GitHub ansehen

@chr-hertel arbeitet bereits daran.

Seit 29.8.2026.

Bewertung

Dieses Issue wurde noch nicht bewertet.

Beschreibung

needs confirmation needs maintainer action

Package slicing

It was discussed already before and we should get this sorted before tagging v1.0: Slicing the monolithic mcp/sdk package into multiple packages.

At least the following packages make sense to me:

mcp/client
mcp/schema
mcp/server

Unclear to me right now: how to deal with extensions? But that's not blocking.

Namespaces

In my understanding this comes with some major shifts in namespaces:
everything that is under Mcp\* needs to go into one of those:

Mcp\Client\*
Mcp\Schema\*
Mcp\Server\*

Exceptions would get distributed into three namespaces below that - with one central interface each.

Monorepo + Subtree Splits

Development (incl. issues and PRs), docs, examples and releases would still happen via the main repository https://github.com/modelcontextprotocol/php-sdk, but the tree packages split into read-only subtrees:

=> meaning PRs only hit modelcontextprotocol/php-sdk and versioning across all packages is synced.

Cross Dependencies
Decoupling namespaces might be the annoying change here, but we should slice cleanly and enforce proper inter-dependencies:

Client can use Schema, but not Server
Server can use Schema, but not Client
Schema mustn't use Client nor Server

Maybe deptrac or similar to enforce.

This is a maintainer issue - community contributions won't be accepted but closed.

Vorherrschende Sprache: PHP
Sterne: 1.6k
Forks: 173
Ø Merge: 2 T. 49 Min.
Gemergte PRs (30 T.): 23

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus modelcontextprotocol/php-sdk

[Server] Handler type uses bare Closure, hard to decorate RegistryInterface under strict PHPStan Offen

Server

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 78/100

modelcontextprotocol/php-sdk#468 · 2 Kommentare · Erstellt am 20.8.2026
Builder::build() silently skips configured file-based discovery when symfony/finder is missing — should fail loudly Offen

needs confirmation needs maintainer action Server

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

modelcontextprotocol/php-sdk#398 · 1 Reaktion · Erstellt am 17.7.2026
[Schema] No support for additonalProperties in tool input schema Offen

enhancement

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

modelcontextprotocol/php-sdk#370 · Erstellt am 31.5.2026
[Server] Decode JSON-RPC objects as stdClass, not associative arrays Offen

enhancement

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100

modelcontextprotocol/php-sdk#510 · 1 Kommentar · Erstellt am 14.9.2026
[Client] HttpTransport resumes an Amp-suspended Fiber with a JSON-RPC error Offen

bug

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 45/100

modelcontextprotocol/php-sdk#504 · Erstellt am 09.9.2026

Alle Issues in modelcontextprotocol/php-sdk