314bdb2f49Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 782b5bad-4046-49ec-93a6-72768b5b7521 Copilot-Session: 4b938335-418c-4ee7-8287-6c70d9148b89
56 lines
3.5 KiB
Markdown
56 lines
3.5 KiB
Markdown
# Conceptual documentation
|
|
|
|
Welcome to the conceptual documentation for the Model Context Protocol SDK. Here you'll find high-level overviews, explanations, and guides to help you understand how the SDK implements the Model Context Protocol.
|
|
|
|
## Contents
|
|
|
|
### Getting started
|
|
|
|
To install the SDK and build your first MCP client and server, see [Getting started](getting-started.md).
|
|
|
|
### Deployment
|
|
|
|
| Title | Description |
|
|
| - | - |
|
|
| [Docker deployment](deployment/docker.md) | Learn how to package and run ASP.NET Core MCP servers in Docker containers using Streamable HTTP transport. |
|
|
|
|
### Base protocol
|
|
|
|
| Title | Description |
|
|
| - | - |
|
|
| [Capabilities](capabilities/capabilities.md) | Learn how client and server capabilities are negotiated during initialization, including protocol version negotiation. |
|
|
| [Transports](transports/transports.md) | Learn how to configure stdio, Streamable HTTP, and SSE transports for client-server communication. |
|
|
| [Stateless and Stateful](stateless/stateless.md) | Learn when to use stateless vs. stateful mode for HTTP servers and how to configure sessions. |
|
|
| [Ping](ping/ping.md) | Learn how to verify connection health using the ping mechanism. |
|
|
| [Progress tracking](progress/progress.md) | Learn how to track progress for long-running operations through notification messages. |
|
|
| [Cancellation](cancellation/cancellation.md) | Learn how to cancel in-flight MCP requests using cancellation tokens and notifications. |
|
|
| [Multi Round-Trip Requests (MRTR)](mrtr/mrtr.md) | Learn how servers request client input during tool execution using input-required results and retries. |
|
|
|
|
### Client features
|
|
|
|
| Title | Description |
|
|
| - | - |
|
|
| [Sampling](sampling/sampling.md) | Learn how servers request LLM completions from the client using the sampling feature. |
|
|
| [Roots](roots/roots.md) | Learn how clients provide filesystem roots to servers for context-aware operations. |
|
|
| [Elicitation](elicitation/elicitation.md) | Learn how to request additional information from users during interactions. |
|
|
|
|
### Server features
|
|
|
|
| Title | Description |
|
|
| - | - |
|
|
| [Tools](tools/tools.md) | Learn how to implement and consume tools that return text, images, audio, and embedded resources. |
|
|
| [Resources](resources/resources.md) | Learn how to expose and consume data through MCP resources, including templates and subscriptions. |
|
|
| [Prompts](prompts/prompts.md) | Learn how to implement and consume reusable prompt templates with rich content types. |
|
|
| [Completions](completions/completions.md) | Learn how to implement argument auto-completion for prompts and resource templates. |
|
|
| [Logging](logging/logging.md) | Learn how to implement logging in MCP servers and how clients can consume log messages. |
|
|
| [Pagination](pagination/pagination.md) | Learn how to use cursor-based pagination when listing tools, prompts, and resources. |
|
|
| [HTTP Context](httpcontext/httpcontext.md) | Learn how to access the underlying `HttpContext` for a request. |
|
|
| [MCP Server Handler Filters](filters.md) | Learn how to add filters to the handler pipeline. Filters let you wrap the original handler with additional functionality. |
|
|
|
|
### Extensions
|
|
|
|
| Title | Description |
|
|
| - | - |
|
|
| [MCP Apps](apps/apps.md) | Learn how to use the MCP Apps extension to deliver interactive UIs from MCP servers. |
|
|
| [Tasks](tasks/tasks.md) | Learn how to use task-based execution for long-running operations that can be polled for status and results. |
|
|
| [Identity and Roles](identity/identity.md) | Learn how to access caller identity and roles in MCP tool, prompt, and resource handlers. |
|