Skip to content

Commit 640dc8a

Browse files
ihrprihrpr
committed
update _meta usage guidance in types
1 parent a3bcabd commit 640dc8a

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

@@ -393,7 +395,8 @@ class Resource(BaseModel):
393395
annotations: Annotations | None = None
394396
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
395397
"""
396-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
398+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
399+
for notes on _meta usage.
397400
"""
398401
model_config = ConfigDict(extra="allow")
399402

@@ -418,7 +421,8 @@ class ResourceTemplate(BaseModel):
418421
annotations: Annotations | None = None
419422
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
420423
"""
421-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
424+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
425+
for notes on _meta usage.
422426
"""
423427
model_config = ConfigDict(extra="allow")
424428

@@ -468,7 +472,8 @@ class ResourceContents(BaseModel):
468472
"""The MIME type of this resource, if known."""
469473
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
470474
"""
471-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
475+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
476+
for notes on _meta usage.
472477
"""
473478
model_config = ConfigDict(extra="allow")
474479

@@ -599,7 +604,8 @@ class Prompt(BaseModel):
599604
"""A list of arguments to use for templating the prompt."""
600605
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
601606
"""
602-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
607+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
608+
for notes on _meta usage.
603609
"""
604610
model_config = ConfigDict(extra="allow")
605611

@@ -636,7 +642,8 @@ class TextContent(BaseModel):
636642
annotations: Annotations | None = None
637643
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
638644
"""
639-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
645+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
646+
for notes on _meta usage.
640647
"""
641648
model_config = ConfigDict(extra="allow")
642649

@@ -655,7 +662,8 @@ class ImageContent(BaseModel):
655662
annotations: Annotations | None = None
656663
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
657664
"""
658-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
665+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
666+
for notes on _meta usage.
659667
"""
660668
model_config = ConfigDict(extra="allow")
661669

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

@@ -700,7 +709,8 @@ class EmbeddedResource(BaseModel):
700709
annotations: Annotations | None = None
701710
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
702711
"""
703-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
712+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
713+
for notes on _meta usage.
704714
"""
705715
model_config = ConfigDict(extra="allow")
706716

@@ -803,7 +813,8 @@ class Tool(BaseModel):
803813
"""Optional additional tool information."""
804814
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
805815
"""
806-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
816+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
817+
for notes on _meta usage.
807818
"""
808819
model_config = ConfigDict(extra="allow")
809820

@@ -1109,7 +1120,8 @@ class Root(BaseModel):
11091120
"""
11101121
meta: dict[str, Any] | None = Field(alias="_meta", default=None)
11111122
"""
1112-
Reserved by MCP for protocol-level metadata; implementations must not make assumptions about its contents.
1123+
See [MCP specification](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/47339c03c143bb4ec01a26e721a1b8fe66634ebe/docs/specification/draft/basic/index.mdx#general-fields)
1124+
for notes on _meta usage.
11131125
"""
11141126
model_config = ConfigDict(extra="allow")
11151127

0 commit comments

Comments
 (0)