Augment conceptual docs with Docker-based MCP server deployment guidance#1423
Conversation
Document how to run ASP.NET Core MCP servers in Docker using Streamable HTTP, including a baseline server example, multi-stage Dockerfile, build/run commands, environment variable configuration, and deployment notes for health checks and reverse proxies. Improve discoverability by adding Docker deployment to conceptual navigation and linking it from transports and getting started docs. Fixes modelcontextprotocol#147
…server-examples # Conflicts: # docs/concepts/index.md # docs/concepts/toc.yml # docs/concepts/transports/transports.md
- Replace the endpoints list: the baseline MapMcp("/mcp") maps only the
Streamable HTTP endpoint. Legacy SSE (/mcp/sse and /mcp/message) is not
mapped by default and the EnableLegacySse option to enable it is obsolete,
in both v1.4.1 and v2.0.0-preview.3. Point readers to the Transports doc.
- Remove the blank line between <!-- mlc-disable-next-line --> and the [!TIP]
and [!IMPORTANT] callouts so the directive applies to the callout line and
suppresses the "reference not found" warnings for [!TIP]/[!IMPORTANT].
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
Thanks @john-mckillip for this contribution and the thorough samples -- a really helpful addition to the deployment docs! I've merged the latest I verified the documented server against both |
jeffhandley
left a comment
There was a problem hiding this comment.
Approving -- verified the documented server builds and serves /mcp against both ModelContextProtocol.AspNetCore 1.4.1 and 2.0.0-preview.3, the DocFX build is clean, and the legacy SSE deprecation is now reflected. Thanks again @john-mckillip!
71d7eea
into
modelcontextprotocol:main
Resolves #147
PR Summary
Augments the conceptual docs with Docker-based MCP server guidance for ASP.NET Core + Streamable HTTP.
What’s Included
Added a new conceptual guide for Docker deployment:
docker.md
Added a Deployment section with Docker in conceptual navigation:
toc.yml
Added Docker deployment to the conceptual docs landing page:
index.md
Added a cross-link from transport guidance to Docker deployment:
transports.md
Added Docker deployment as a next step in getting started docs:
getting-started.md
Docker Guide Coverage
WithHttpTransport+MapMcp)/mcpand legacy/mcp/sse)Scope
Validation
dotnet buildpasseddotnet testpassed after installing Node conformance dependencies vianpm ci