modelcontextprotocol / modelcontextprotocol/java-sdk

standardize tool metadata by adding annotation classes to sdk

Offen
#224 9 Kommentare 1 Reaktion 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

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

Beschreibung

Expected Behavior

It would be ideal to have Tool annotation classes (specifically Tool/ToolParam) be added to the mcp-java-sdk.

Current Behavior

Multiple, tool-specific annotations exist, the most prominent being spring's:

https://github.com/spring-projects/spring-ai/tree/main/spring-ai-model/src/main/java/org/springframework/ai/tool/annotation

These annotations (and the one interface dependency) should be a part of the java mcp-sdk itself, rather than require spring dependencies (or other emerging implementations).

Context
b
It would be helpful to have Tool/ToolParam/ToolAnnotations/ToolResult annotations that are part of the java sdk, so that the MCP developer would not have to change annotations to use a different framework. Having Tool/ToolParam/ToolAnnotations/ToolResult annotations as part of the mcp itself rather than spring or any other specific framework would aid in that effort.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginne damit, das im Issue verlinkte Spring AI-Annotationsverzeichnis zu prüfen und dessen Tool-, ToolParam-, ToolAnnotations- und ToolResult-Annotationen mit dem aktuellen mcp-java-sdk zu vergleichen. Als abgeschlossen gilt die Arbeit, wenn das SDK frameworkunabhängige Entsprechungen bereitstellt, sodass MCP-Entwickler dieselben Annotationen ohne Spring oder eine andere Implementierungsabhängigkeit verwenden können.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
java, spring
Bereich
api, backend-api-design
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
38/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.