modelcontextprotocol / modelcontextprotocol/java-sdk

standardize tool metadata by adding annotation classes to sdk

Aberta
#224 9 comentários 1 reação 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

enhancement
Linguagem predominante
Java
Estrelas
3.7k
Forks
1.1k
Merge médio
1d 15h
PRs com merge (30d)
9

Descrição

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.

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Comece revisando o diretório de anotações do Spring AI vinculado na issue e comparando suas anotações Tool, ToolParam, ToolAnnotations e ToolResult com o mcp-java-sdk atual. O trabalho estará concluído quando o SDK fornecer equivalentes independentes de framework, para que os desenvolvedores de MCP possam usar as mesmas anotações sem Spring ou outra dependência de implementação.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
java, spring
Domínio
api, backend-api-design
Tipo de issue
Funcionalidade
Dificuldade
5/5
Tempo estimado
Mais de uma semana
Status de atividade
Estagnada
Clareza
Razoavelmente clara
Facilidade para iniciantes
38/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.