modelcontextprotocol / modelcontextprotocol/java-sdk

standardize tool metadata by adding annotation classes to sdk

Ouverte
#224 9 commentaires 1 réaction 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

enhancement
Langage dominant
Java
Étoiles
3.7k
Forks
1.1k
Merge moyen
1 j 15 h
PR mergées (30 j)
9

Description

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.

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par examiner le répertoire d’annotations Spring AI lié dans l’issue et comparer ses annotations Tool, ToolParam, ToolAnnotations et ToolResult avec le mcp-java-sdk actuel. Le travail est considéré comme terminé lorsque le SDK fournit des équivalents indépendants du framework, afin que les développeurs MCP puissent utiliser les mêmes annotations sans Spring ni autre dépendance d’implémentation.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
java, spring
Domaine
api, backend-api-design
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
38/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.