component-shape-mcp 0.3.0

Shared MCP protocol and schema helpers for component-shape integrations.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! Shared MCP schemas, tool registries, and `rmcp` server glue for
//! component-shape integrations.
//!
//! This crate owns protocol-level building blocks, schema-paired value
//! decoding, and common validation metadata/error helpers. Domain integrations
//! still own validation execution, authorization, and handler contracts.

mod arguments;
mod definitions;
mod error;
mod input_schema;
mod metadata;
mod names;
mod results;
mod schema;
mod server;
mod stdio_smoke;
mod validation;

use std::{
    borrow::Cow,
    collections::{BTreeMap, BTreeSet, HashMap, HashSet},
    fmt,
    future::Future,
    hash::Hash,
    marker::PhantomData,
    ops::Index,
    path::{Path, PathBuf},
    pin::Pin,
    sync::Arc,
};

pub use arguments::*;
pub use component_shape::{
    ComponentShapeFor, ComponentShapeMetadata, McpInput, McpInputShape, McpPrimitiveKind,
    McpRangeBoundKind,
};
#[cfg(feature = "derive")]
pub use component_shape_mcp_macros::{McpJsonSchema, McpToolInput};
pub use definitions::*;
pub(crate) use definitions::{validate_required_metadata_text, validate_tool_annotation_hints};
pub use error::*;
pub(crate) use error::{
    normalize_value_against_schema, reject_unknown_arguments, validate_value_against_closed_schema,
};
pub(crate) use input_schema::value_schema_allows_null;
pub use input_schema::*;
pub use metadata::*;
pub use names::*;
pub use results::*;
pub use rmcp;
pub use rmcp::model::{
    CallToolResult as ToolCallResult, ContentBlock, GetPromptResult as McpPromptResult,
    Icon as McpIcon, IconTheme as McpIconTheme, Prompt as PromptDefinition,
    PromptArgument as McpPromptArgument, PromptMessage as McpPromptMessage,
    ReadResourceResult as McpResourceResult, Resource as ResourceDefinition,
    ResourceContents as McpResourceContents, ResourceTemplate as ResourceTemplateDefinition,
    Role as McpRole, Tool as ToolDefinition, ToolAnnotations as McpToolAnnotations,
};
use rmcp::{
    ErrorData, RoleServer, ServerHandler, ServiceExt as _,
    model::{
        CacheScope, CallToolRequestParams, CallToolResponse, GetPromptRequestParams,
        GetPromptResponse, GetPromptResult, Implementation, JsonObject, ListPromptsResult,
        ListResourceTemplatesResult, ListResourcesResult, ListToolsResult, MetaObject,
        PaginatedRequestParams, Prompt, PromptMessage, ProtocolVersion, ReadResourceRequestParams,
        ReadResourceResponse, ReadResourceResult, Resource, ResourceContents, ResourceTemplate,
        Role, ServerCapabilities, ServerInfo, Tool,
    },
    service::{MaybeSendFuture, RequestContext},
    transport::stdio,
};
pub use schema::*;
pub use serde;
use serde::{Deserialize, Serialize, de::DeserializeOwned};
pub use serde_json;
use serde_json::{Map, Number, Value, json};
pub use server::*;
pub use stdio_smoke::*;
use strum::IntoStaticStr;
pub use validation::*;

pub const MCP_PROTOCOL_VERSION: &str = "2026-07-28";

pub type ServeStdioResult = Result<(), Box<dyn std::error::Error + Send + Sync + 'static>>;
pub type McpToolArguments = Map<String, Value>;
pub type McpSchemaProperties = BTreeMap<String, McpSchema>;
pub type McpSchemaFn = fn() -> McpSchema;
type ToolFuture = Pin<Box<dyn Future<Output = ToolCallResult> + Send + 'static>>;
type ResourceFuture =
    Pin<Box<dyn Future<Output = Result<ReadResourceResult, ErrorData>> + Send + 'static>>;
type PromptFuture =
    Pin<Box<dyn Future<Output = Result<GetPromptResult, ErrorData>> + Send + 'static>>;

#[cfg(test)]
mod tests;