fastmcp-rs 0.2.0

Rust prototype for the FastMCP server
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

use std::fmt;
use std::io;

use serde_json::Value;
use thiserror::Error;

/// Result alias used across the crate.
pub type Result<T, E = FastMcpError> = std::result::Result<T, E>;

/// Errors surfaced by the FastMCP Rust prototype.
#[derive(Debug, Error)]
pub enum FastMcpError {
    #[error("tool '{0}' already registered")]
    DuplicateTool(String),
    #[error("tool '{0}' not found")]
    ToolNotFound(String),
    #[error("resource '{0}' already registered")]
    DuplicateResource(String),
    #[error("resource '{0}' not found")]
    ResourceNotFound(String),
    #[error("prompt '{0}' already registered")]
    DuplicatePrompt(String),
    #[error("prompt '{0}' not found")]
    PromptNotFound(String),
    #[error("invalid invocation payload: {0}")]
    InvalidInvocation(String),
    #[error("handler error: {0}")]
    HandlerError(String),
    #[error("serialization error: {0}")]
    Serialization(#[from] serde_json::Error),
    #[error("io error: {0}")]
    Io(#[from] io::Error),
}

impl FastMcpError {
    /// Convenience helper for building handler errors from any displayable type.
    pub fn handler_error(err: impl fmt::Display) -> Self {
        Self::HandlerError(err.to_string())
    }
}

/// Helper for validating the presence of a JSON object.
pub fn expect_object<'a>(
    payload: &'a Value,
    context: &'static str,
) -> Result<&'a serde_json::Map<String, Value>> {
    payload
        .as_object()
        .ok_or_else(|| FastMcpError::InvalidInvocation(format!("{context} expects a JSON object")))
}