Missing prompt-level _meta support in MCPServer.prompt() and Prompt model

Aberta

#3,476 aberta em 8/9/2026 1 comentário 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade: 3/5
Tempo estimado: 1-2 dias
Facilidade para iniciantes: 68/100

Tipo de issue: Funcionalidade
Clareza: Razoavelmente clara
Status de atividade: Ativa
Stack de tecnologia: python
Domínio: api, backend-api-design

Direção de pesquisa

Comece em MCPServer.prompt e no modelo Prompt de alto nível; em seguida, acompanhe como list_prompts serializa os campos do prompt. Confirme como @mcp.tool aceita meta e como sua operação list emite _meta; considera-se concluído quando @mcp.prompt aceita os metadados sem um TypeError e list_prompts os retorna como _meta.

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

Descrição

v1 v2

Initial Checks

I confirm that I'm using the newest release of my line (the latest 2.x, or the latest 1.x if I'm still on v1)
I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue

Release line

2.x (current stable)

Description

The 2026-07-28 specification defines the optional _meta field on the Prompt schema. While other decorators like @mcp.tool support meta and pass it down as _meta on serialization (e.g., in MCPServer.list_tools). The @mcp.prompt decorator and the high-level Prompt classes are missing support for meta.

Expected Behavior

Including meta on @mcp.prompt does not incur a type error and returns _meta for the prompt on list_prompts.

Example Code

from mcp.server.mcpserver import MCPServer

# ATTEMPTING TO USE METADATA ON PROMPTS
mcp = MCPServer("MetaTestServer")

# This currently raises a TypeError because meta is not a parameter in @mcp.prompt
@mcp.prompt(name="code_review",title="Code Review",
            description="Review code with specific metadata rules",
            meta={"strictness": "high"})
def review_code(code: str) -> str:
    return f"Review this: {code}"
   
# 2. EXPECTED BEHAVIOR
# If the decorator parameter was supported, list_prompts should return prompt with _meta:
# listed_prompts = await mcp.list_prompts()
# assert listed_prompts[0].meta == {"audience": "strictness": "high"}

Python & MCP Python SDK

- Python: 3.12+
- MCP Python SDK: 2.2.0

Linguagem predominante: Python
Estrelas: 24.3k
Forks: 4k
Merge médio: 1d 19min
PRs com merge (30d): 29

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

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