Skip to content

Commit 5429ac6

Browse files
ihrprihrpr
authored
Update _meta usage guidance in types (#971)
1 parent 69e6572 commit 5429ac6

File tree

1 file changed

+24
-12
lines changed

1 file changed

+24
-12
lines changed

‎src/mcp/types.py

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,8 @@ class Meta(BaseModel):
6969

7070
meta: Meta | None = Field(alias="_meta", default=None)
7171
"""
72-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
72+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
73+
for notes on _meta usage.
7374
"""
7475

7576

@@ -106,7 +107,8 @@ class Result(BaseModel):
106107

107108
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
108109
"""
109-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
110+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
111+
for notes on _meta usage.
110112
"""
111113
model_config = ConfigDict(extra="allow")
112114

@@ -401,7 +403,8 @@ class Resource(BaseModel):
401403
annotations: Annotations | None = None
402404
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
403405
"""
404-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
406+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
407+
for notes on _meta usage.
405408
"""
406409
model_config = ConfigDict(extra="allow")
407410

@@ -426,7 +429,8 @@ class ResourceTemplate(BaseModel):
426429
annotations: Annotations | None = None
427430
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
428431
"""
429-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
432+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
433+
for notes on _meta usage.
430434
"""
431435
model_config = ConfigDict(extra="allow")
432436

@@ -476,7 +480,8 @@ class ResourceContents(BaseModel):
476480
"""The MIME type of this resource, if known."""
477481
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
478482
"""
479-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
483+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
484+
for notes on _meta usage.
480485
"""
481486
model_config = ConfigDict(extra="allow")
482487

@@ -607,7 +612,8 @@ class Prompt(BaseModel):
607612
"""A list of arguments to use for templating the prompt."""
608613
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
609614
"""
610-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
615+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
616+
for notes on _meta usage.
611617
"""
612618
model_config = ConfigDict(extra="allow")
613619

@@ -644,7 +650,8 @@ class TextContent(BaseModel):
644650
annotations: Annotations | None = None
645651
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
646652
"""
647-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
653+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
654+
for notes on _meta usage.
648655
"""
649656
model_config = ConfigDict(extra="allow")
650657

@@ -663,7 +670,8 @@ class ImageContent(BaseModel):
663670
annotations: Annotations | None = None
664671
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
665672
"""
666-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
673+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
674+
for notes on _meta usage.
667675
"""
668676
model_config = ConfigDict(extra="allow")
669677

@@ -682,7 +690,8 @@ class AudioContent(BaseModel):
682690
annotations: Annotations | None = None
683691
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
684692
"""
685-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
693+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
694+
for notes on _meta usage.
686695
"""
687696
model_config = ConfigDict(extra="allow")
688697

@@ -708,7 +717,8 @@ class EmbeddedResource(BaseModel):
708717
annotations: Annotations | None = None
709718
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
710719
"""
711-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
720+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
721+
for notes on _meta usage.
712722
"""
713723
model_config = ConfigDict(extra="allow")
714724

@@ -811,7 +821,8 @@ class Tool(BaseModel):
811821
"""Optional additional tool information."""
812822
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
813823
"""
814-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
824+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
825+
for notes on _meta usage.
815826
"""
816827
model_config = ConfigDict(extra="allow")
817828

@@ -1117,7 +1128,8 @@ class Root(BaseModel):
11171128
"""
11181129
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
11191130
"""
1120-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
1131+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
1132+
for notes on _meta usage.
11211133
"""
11221134
model_config = ConfigDict(extra="allow")
11231135

0 commit comments

Comments
 (0)