POST /mcp with a missing or unparseable Content-Type returns HTTP 500 instead of a 4xx

Aberta Para iniciantes
#1,966 5 comentários 0 reações 1 responsável Ver no GitHub

Mantenedores costumam responder em até 1 dia

@halter73 já está trabalhando nisso.

Desde 11/11/2026.

  • #2026 de @aaryagodbole — aberto

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
72/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
csharp, json
Domínio
api, backend

Direção de pesquisa

O repro (app.cs) já isola o comportamento: text/plain chega a um 415, enquanto os casos ausente, vazio e /json caem no leitor de body JSON e lançam InvalidOperationException. Comece no transporte ASP.NET Core, no ponto em que o endpoint Streamable HTTP do MapMcp verifica o content type da requisição antes de ler o body, e veja por que um valor não parseável pula essa verificação. O resultado esperado é que todos os quatro casos ruins retornem um 4xx (415), mais um teste no projeto de teste AspNetCore cobrindo cada um deles.

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

Descrição

bug

Describe the bug
A Streamable HTTP POST whose Content-Type header is missing, empty or cannot be parsed as JSON throws an unhandled InvalidOperationException and the server returns HTTP 500. A well-formed but non-JSON type such as text/plain gets a 415.

To Reproduce
Save this as app.cs and run dotnet run app.cs. It hosts a minimal stateless MCP server in-process and POSTs an initialize request with different Content-Type values.

#:sdk Microsoft.NET.Sdk.Web
#:package [email protected]

// Reproduction: a Streamable HTTP POST with a missing or unparseable Content-Type returns HTTP 500
// (unhandled InvalidOperationException) instead of a 4xx.
//
// Run with: dotnet run app.cs   (.NET 10 SDK)

using System.ComponentModel;
using System.Text;
using ModelContextProtocol.Server;

var builder = WebApplication.CreateBuilder(args);
builder.Logging.SetMinimumLevel(LogLevel.None);
builder.WebHost.UseUrls("http://127.0.0.1:0");
builder.Services
    .AddMcpServer()
    .WithHttpTransport(options => options.Stateless = true)
    .WithTools<EchoTool>();

var app = builder.Build();

// Observe only: print the exception that escapes the SDK handler, then rethrow so the host
// still produces its normal response.
app.Use(async (context, next) =>
{
    try
    {
        await next();
    }
    catch (Exception exception)
    {
        Console.WriteLine($"    unhandled {exception.GetType().Name}: {exception.Message}");
        throw;
    }
});
app.MapMcp("/mcp");
await app.StartAsync();

const string initialize =
    """{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"repro","version":"1.0"}}}""";

string?[] contentTypes =
[
    "application/json",
    "text/plain",
    null,
    "",
    "/json"
];

using var client = new HttpClient { BaseAddress = new Uri(app.Urls.First()) };

Console.WriteLine($"{"Content-Type",-30} Status");
foreach (var contentType in contentTypes)
{
    using var request = new HttpRequestMessage(HttpMethod.Post, "/mcp");
    request.Headers.Accept.ParseAdd("application/json");
    request.Headers.Accept.ParseAdd("text/event-stream");
    request.Content = new StringContent(initialize, Encoding.UTF8);
    request.Content.Headers.Remove("Content-Type");

    if (contentType is not null)
        request.Content.Headers.TryAddWithoutValidation("Content-Type", contentType);

    using var response = await client.SendAsync(request);
    Console.WriteLine($"{contentType switch { null => "<absent>", "" => "<empty>", _ => contentType },-30} {(int)response.StatusCode}");
}

await app.StopAsync();

[McpServerToolType]
public sealed class EchoTool
{
    [McpServerTool, Description("Echoes the message.")]
    public static string Echo(string message) => message;
}

Expected behavior
A 4xx response (for example 415, as text/plain already gets) instead of a 500.

Logs

Content-Type                   Status
application/json               200
text/plain                     415
    unhandled InvalidOperationException: Unable to read the request as JSON because the request content type '' is not a known JSON content type.
<absent>                       500
    unhandled InvalidOperationException: Unable to read the request as JSON because the request content type '' is not a known JSON content type.
<empty>                        500
    unhandled InvalidOperationException: Unable to read the request as JSON because the request content type '/json' is not a known JSON content type.
/json                          500

Additional context

  • Reproduced on ModelContextProtocol.AspNetCore 2.3.0
Linguagem predominante
C#
Estrelas
4.6k
Forks
849
Merge médio
1d 16h
PRs com merge (30d)
24

Preparar o ambiente

Abrir no Codespaces

Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.

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.

Mais de modelcontextprotocol/csharp-sdk

Todas as issues de modelcontextprotocol/csharp-sdk

Issues semelhantes

Mais issues de C#

Receba novas issues na sua caixa de entrada

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