Watch

History

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
dependabot[bot] dbd2382755 Some checks failed CI / Lint Commit Messages (push) Has been cancelled Details CI / Code Formatting (push) Has been cancelled Details CI / Lint with Clippy (push) Has been cancelled Details CI / SemVer Check (push) Has been cancelled Details CI / Public API Check (push) Has been cancelled Details CI / spell check with typos (push) Has been cancelled Details CI / Check MSRV (push) Has been cancelled Details CI / Run Tests (push) Has been cancelled Details CI / Run Tests (no local feature) (push) Has been cancelled Details CI / Code Coverage (push) Has been cancelled Details CI / Example test (push) Has been cancelled Details CI / Security Audit (push) Has been cancelled Details CI / Generate Documentation (push) Has been cancelled Details CodeQL / Analyze (push) Has been cancelled Details CodeQL / Analyze-1 (push) Has been cancelled Details CodeQL / Analyze-2 (push) Has been cancelled Details CodeQL / Analyze-3 (push) Has been cancelled Details Conformance / server (push) Has been cancelled Details Conformance / client (push) Has been cancelled Details Release-plz / Release-plz release (push) Has been cancelled Details Release-plz / Release-plz PR (push) Has been cancelled Details Scorecard supply-chain security / Scorecard analysis (push) Has been cancelled Details CI / Release crates (push) Has been cancelled Details chore(deps): update rstest requirement from 0.26.1 to 0.27.0 (#1276 ) Updates the requirements on [rstest](https://github.com/la10736/rstest) to permit the latest version. - [Release notes](https://github.com/la10736/rstest/releases) - [Changelog](https://github.com/la10736/rstest/blob/master/CHANGELOG.md) - [Commits](https://github.com/la10736/rstest/compare/v0.26.1...v0.27.0) --- updated-dependencies: - dependency-name: rstest dependency-version: 0.27.0 dependency-type: direct:production ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>		2026-09-18 13:47:35 -04:00
..
src	fix(rmcp): route peer cancellation by lifecycle (#1262 )	2026-09-14 16:22:57 -04:00
tests	fix(rmcp): use ServerConfig in cancellation test (#1273 )	2026-09-15 11:18:33 -04:00
build.rs	chore: add pre-commit hook for conventional commit verification (#619 )	2026-01-14 16:01:28 -05:00
Cargo.toml	chore(deps): update rstest requirement from 0.26.1 to 0.27.0 (#1276 )	2026-09-18 13:47:35 -04:00
CHANGELOG.md	chore: release v3.4.0 (#1258 )	2026-09-15 11:37:39 -04:00
README.md	feat(auth): add enterprise refresh-token and ID-JAG exchanges (#1234 )	2026-09-04 15:04:08 -04:00

README.md

rmcp

The official Rust SDK for the Model Context Protocol. Build MCP servers that expose tools, resources, and prompts to AI assistants — or build clients that connect to them.

For getting started, usage guides, and full MCP feature documentation (resources, prompts, sampling, roots, logging, completions, subscriptions, etc.), see the main README.

Feature Flags

Feature	Description	Default
`server`	Server functionality and the tool system	✅
`client`	Client functionality
`macros`	`#[tool]` / `#[prompt]` macros (re-exports `rmcp-macros`)	✅
`schemars`	JSON Schema generation for tool definitions
`auth`	OAuth 2.0 authentication support
`auth-enterprise-managed`	EMA/XAA refresh-token and ID-JAG exchanges for registered public and confidential clients (includes `auth`)
`elicitation`	Elicitation support

Transport features

Feature	Description
`transport-io`	Server-side stdio transport
`transport-child-process`	Client-side stdio transport (spawns a child process)
`transport-async-rw`	Generic async read/write transport
`transport-streamable-http-client`	Streamable HTTP client (transport-agnostic)
`transport-streamable-http-client-reqwest`	Streamable HTTP client with default `reqwest` backend
`transport-streamable-http-server`	Streamable HTTP server transport

TLS backend options (for HTTP transports)

Feature	Description
`reqwest`	Uses rustls — pure Rust TLS (recommended default)
`reqwest-native-tls`	Uses platform-native TLS (OpenSSL / Secure Transport / SChannel)
`reqwest-tls-no-provider`	Uses rustls without a default crypto provider (bring your own)

For enterprise-managed authorization, enable auth-enterprise-managed and a TLS backend such as reqwest. See the EMA/XAA guide for client authentication and an MCP connection example.

Transports

The transport layer is pluggable. Two built-in pairs cover the most common cases:

	Client	Server
stdio	`TokioChildProcess`	`stdio`
Streamable HTTP	`StreamableHttpClientTransport`	`StreamableHttpService`

Any type that implements the Transport trait can be used. The IntoTransport helper trait provides automatic conversions from:

(Sink, Stream) or a combined Sink + Stream
(AsyncRead, AsyncWrite) or a combined AsyncRead + AsyncWrite
A Worker implementation
A Transport implementation directly

License

This project is licensed under the terms specified in the repository's LICENSE file.