Publish a `mcp-annotations` module with just annotations for MCP Server primitives annotations.

Offen

#491 erstellt am 14.8.2025 6 Kommentare 2 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 4/5
Geschätzter Aufwand: 3-5 Tage
Anfängerfreundlichkeit: 35/100

Issue-Typ: Feature
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Tech-Stack: java
Bereich: backend-api-design

Rechercherichtung

Beginne mit der Prüfung des verlinkten Beispiels für die Quarkus Tool.java-Annotation und des Modulaufbaus des java-sdk-Repositorys. Bestimme den standardmäßigen Annotationssatz für MCP Server-Primitiven und definiere das neue mcp-annotations-Modul; abgeschlossen ist die Aufgabe, wenn das Modul mit den vereinbarten Annotationen zur Verwendung durch nachgelagerte Frameworks veröffentlicht ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

enhancement

Would you be open to publish a new module mcp-annotations with just a "standard" set of annotations for MCP Server Primitives (@Tool, @ToolArg, @Prompt, ...)?.

Those annotations could be used by frameworks downstream. That way we would avoid having to duplicate these annotations in the different frameworks.

E.g. Quarkus @Tool annotation:

https://github.com/quarkiverse/quarkus-mcp-server/blob/main/core/runtime/src/main/java/io/quarkiverse/mcp/server/Tool.java

Vorherrschende Sprache: Java
Sterne: 3.7k
Forks: 1.1k
Ø Merge: 1 T. 15 Std.
Gemergte PRs (30 T.): 9

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/java-sdk

SSE client silently truncates a data: line at U+2028/U+2029/U+0085, then fails with "Error parsing JSON-RPC message" Offen

area/transport bug P2

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

modelcontextprotocol/java-sdk#1136 · Erstellt am 18.9.2026
Client request handlers that complete empty send no JSON-RPC response Offen

area/client bug P2

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

modelcontextprotocol/java-sdk#1124 · 1 Kommentar · Erstellt am 03.9.2026
ServerCapabilities.logging is added unconditionally, overriding the caller's explicit capabilities Offen

bug P2 ready for work

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

modelcontextprotocol/java-sdk#1086 · 1 Kommentar · Erstellt am 11.8.2026
Reject listRoots if not supported by client, without sending any request Offen

enhancement good first issue P3

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

modelcontextprotocol/java-sdk#1067 · Erstellt am 19.7.2026
StdioClientTransport missing explicit UTF-8 charset in InputStreamReader (same issue as #295, but on client side) Offen

bug P2 ready for work

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

modelcontextprotocol/java-sdk#898 · 1 Kommentar · Erstellt am 02.4.2026

Alle Issues in modelcontextprotocol/java-sdk