icarus-core 0.6.0

Core abstractions for building MCP servers on ICP
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

// Copyright (c) 2025 Icarus Team. All Rights Reserved.
// Licensed under BSL-1.1. See LICENSE and NOTICE files.
// Signature verification and telemetry must remain intact.

// #![warn(missing_docs)] // TODO: Enable after adding all documentation

//! Core abstractions for building MCP servers on ICP
//!
//! This crate provides the fundamental traits and types for creating
//! Model Context Protocol servers that run as Internet Computer canisters.

pub mod compatibility;
pub mod error;
pub mod lifecycle;
pub mod persistent;
pub mod protocol;
pub mod registry;
pub mod response;
pub mod server;
pub mod session;
pub mod state;
pub mod tool;

pub use compatibility::{
    IcarusParam, IcarusReturn, IcarusTool as IcarusToolCompatible, ToolResult,
};
pub use error::{IcarusError, Result, ToolError};
pub use response::{tool_ok, tool_success, ToolStatus, ToolSuccess};
pub use server::IcarusServer;
pub use tool::IcarusTool;

/// Prelude module for convenient imports
///
/// Import everything you need with:
/// ```
/// use icarus_core::prelude::*;
/// ```
pub mod prelude {
    pub use crate::{
        error::{IcarusError, Result, ToolError},
        lifecycle::IcarusServerLifecycle,
        persistent::{IcarusPersistentState, TypedPersistentState},
        registry::IcarusToolRegistry,
        response::{tool_ok, tool_success, ToolStatus, ToolSuccess},
        server::IcarusServer,
        tool::IcarusTool,
    };
}