Support C# union return values in tools, prompts, and resources
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 55/100
- Issue 类型
- 缺陷
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- csharp
调研方向
Read the result switches in AIFunctionMcpServerTool.cs, AIFunctionMcpServerPrompt.cs, and AIFunctionMcpServerResource.cs, then trace how their current cases handle direct return values. Check how compiler generated unions expose their active case and account for older target frameworks and Native AOT. Done means union cases behave like their directly returned values across tools, prompts, and resources while preserving output schemas and older protocol compatibility.
由索引模型根据 Issue 内容生成。
描述
Description
When a tool, prompt, or resource method returns a C# union, its active case is not handled like the same value returned directly. The SDK's result conversion sees the boxed union rather than the active value.
Reproduction
Run this with the .NET 11 SDK, targeting net11.0 with LangVersion set to preview:
using System;
using System.IO;
using ModelContextProtocol.Protocol;
using ModelContextProtocol.Server;
await using var server = McpServer.Create(
new StreamServerTransport(Stream.Null, Stream.Null),
new McpServerOptions());
var tool = McpServerTool.Create(
() => (TextOrImage)"hello",
new() { Name = "example" });
var request = new RequestContext<CallToolRequestParams>(
server,
new JsonRpcRequest { Method = "tools/call" },
new CallToolRequestParams { Name = "example" });
var result = await tool.InvokeAsync(request);
Console.WriteLine(((TextContentBlock)result.Content[0]).Text);
public union TextOrImage(string, ImageContentBlock);
The text contains "hello", including the quote characters. Returning "hello" directly produces hello without those characters. An ImageContentBlock case is similarly serialized into a text block instead of being returned as image content. A CallToolResult case is serialized into text rather than passed through, so properties such as IsError are not propagated as result properties.
Prompts and resources have the same underlying issue, but throw instead of falling back to JSON serialization. For example, a prompt returning the string case of union TextOrPrompt(string, PromptMessage) throws InvalidOperationException: Unknown result type 'TextOrPrompt' returned from prompt function. A resource returning the string case of union TextOrResource(string, ResourceContents) throws InvalidOperationException: Unsupported result type 'TextOrResource' returned from resource function.
Expected behavior
Handle a union's active case as the corresponding directly returned value for tools, prompts, and resources. Preserve the existing handling of ordinary return values, structured content and output schemas, including compatibility with older protocol versions.
Investigation
The result switches in AIFunctionMcpServerTool, AIFunctionMcpServerPrompt, and AIFunctionMcpServerResource match the boxed union rather than its active case. Compiler-generated unions implement System.Runtime.CompilerServices.IUnion on .NET 11; the SDK also targets older frameworks, so compatibility and Native AOT need consideration.
Reproduced against the SDK at commit 64cfd66b147553d8cf953f9e2a374aae96014968, using its net10.0 Core build in a .NET 11 application.
[!NOTE]
This issue was drafted with GitHub Copilot.
- 主要语言
- C#
- 星标
- 4.6k
- 派生
- 849
- 平均合并
- 1 天 16 小时
- 30 天内合并 PR
- 24
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
modelcontextprotocol/csharp-sdk 的其他 Issue
-
难度 1/5 1 小时以内 新手友好度 88/100
modelcontextprotocol/csharp-sdk#2031 ·
维护者通常 1 天内回复
-
Static resources whose URIs differ only in the fragment or user info collapse into one可能已有人在做 @halter73 于 9 天前认领。 未关闭P2
难度 2/5 1-3 小时 新手友好度 78/100
modelcontextprotocol/csharp-sdk#1970 · 4 条评论 · 已指派 1 人 ·
维护者通常 1 天内回复
-
POST /mcp with a missing or unparseable Content-Type returns HTTP 500 instead of a 4xx可能已有人在做 @halter73 于 9 天前认领。 未关闭bug
难度 2/5 1-3 小时 新手友好度 72/100
modelcontextprotocol/csharp-sdk#1966 · 5 条评论 · 已指派 1 人 ·
维护者通常 1 天内回复
-
Reserved URI-template expansion throws for supplementary Unicode characters可能已有人在做 @tarekgh 于 2 天前认领。 未关闭P3
难度 2/5 1-3 小时 新手友好度 74/100
modelcontextprotocol/csharp-sdk#1913 · 1 条评论 · 已指派 1 人 ·
维护者通常 1 天内回复
-
ClaimsPrincipal parameter injection sample request可能已有人在做 @utsavjain2809 于 48 天前认领。 未关闭help wanted P3
难度 2/5 1-3 小时 新手友好度 74/100
modelcontextprotocol/csharp-sdk#1899 ·
维护者通常 1 天内回复
查看 modelcontextprotocol/csharp-sdk 的全部 Issue
相似的 Issue
-
account bug effort:S P2
难度 2/5 1-3 小时 新手友好度 78/100
nightscout/nocturne#3745 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
grate-devs/grate#969 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 70/100
jsboige/CoursIA#27768 · 2 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 63/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 62/100
martin-stromberg/FinanceManager#562 ·
维护者通常 1 天内回复