Crate systemprompt_mcp

Expand description

Native Model Context Protocol (MCP) implementation for systemprompt.io.

This crate hosts the in-process MCP server runtime, the registry/orchestrator that supervises per-tenant MCP child processes, the OAuth2/RBAC middleware, and the tool/resource/UI-renderer abstractions used across the platform.

§Layered components

extension::McpExtension — Extension registration entry-point.
services::McpOrchestrator — top-level service supervisor.
services::registry::RegistryService — registry of MCP servers configured via services.yaml.
services::tool_provider::McpToolProvider — tool-discovery + execution facade.
middleware::rbac — JWT/proxy-verified RBAC layer.
orchestration — multi-server lifecycle/state management.
repository — Postgres persistence for sessions, artifacts, tool usage.

§Feature matrix

This crate has no Cargo features today; it is built as a single unit. The facade crate systemprompt gates this crate behind the mcp / full features.

§Errors

All public APIs return McpDomainResult — a typed Result aliased over McpDomainError. External error types (sqlx, serde_json, io, join errors) are composed via #[from] on the error enum. Third-party errors without a typed adapter are converted at the boundary with .map_err(|e| McpDomainError::Internal(e.to_string())).

Copyright (c) systemprompt.io — Business Source License 1.1. See https://systemprompt.io for licensing details.

Re-exports§

pub use repository::CreateMcpArtifact;
pub use repository::McpArtifactRecord;
pub use repository::McpArtifactRepository;
pub use services::ui_renderer::templates::html::artifact_shell_template;
pub use services::ui_renderer::artifact_resource_uri;
pub use services::ui_renderer::parse_artifact_resource_uri;
pub use services::monitoring::health::HealthStatus;
pub use services::monitoring::status::McpServiceStatus;
pub use services::registry::RegistryService;
pub use services::registry::trait_impl::McpDeploymentProviderImpl;
pub use services::tool_provider::McpToolProvider;
pub use services::EventBus as McpEventBus;
pub use services::McpEvent;
pub use services::McpOrchestrator;
pub use orchestration::McpServerConnectionInfo;
pub use orchestration::McpServiceState;
pub use orchestration::McpToolLoader;
pub use orchestration::ServerStatus;
pub use orchestration::ServiceStateService;
pub use orchestration::SkillLoadingResult;

Modules§

middleware: HTTP-facing middleware for the MCP server: RBAC enforcement, database-backed session management, and request-context/bearer-token extraction helpers.
models: Domain models for MCP — sessions, artifacts, validation results, etc.
orchestration: Multi-server lifecycle and state orchestration: tool discovery/loading across MCP servers and runtime service-state lookups backed by the database.
registry
repository: Postgres persistence for MCP: tool-execution records and aggregate stats, session state, and tool-output artifacts.
services: Publicly re-exported submodule. See submodule rustdoc for details.