turbomcp-proxy 3.0.9

Universal MCP adapter/generator - introspection, proxying, and code generation for any MCP server
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

//! turbomcp-proxy: Universal MCP Adapter/Generator
//!
//! A universal tool that works with ANY MCP server implementation (`TurboMCP`, Python SDK,
//! TypeScript SDK, custom implementations). It discovers server capabilities via the MCP
//! protocol and dynamically generates adapters for different transports and protocols.
//!
//! # Features
//!
//! - **Universal MCP Adapter**: Works with MCP servers that implement the current protocol surface
//! - **Zero Configuration**: Discovers capabilities via introspection
//! - **Multiple Modes**: Runtime (fast), Codegen (optimized), Schema export
//! - **Protocol Translation**: Expose MCP as REST API, GraphQL, gRPC
//!
//! # Quick Start
//!
//! ```bash
//! # Inspect any MCP server
//! turbomcp-proxy inspect stdio --cmd "python my-server.py"
//!
//! # Expose STDIO server over HTTP/SSE
//! turbomcp-proxy serve \
//!   --backend stdio --cmd "python my-server.py" \
//!   --frontend http --bind 0.0.0.0:3000
//! ```
//!
//! # Architecture
//!
//! ```text
//! ┌─────────────────────────────────────────────────────────┐
//! │ Introspection Layer                                     │
//! │ • McpIntrospector: Discovers server capabilities       │
//! │ • ServerSpec: Complete server description               │
//! └─────────────────────────────────────────────────────────┘
//!                           ↓
//! ┌─────────────────────────────────────────────────────────┐
//! │ Generation Layer                                        │
//! │ • RuntimeProxyBuilder: Dynamic, no codegen              │
//! │ • RustCodeGenerator: Optimized Rust source              │
//! └─────────────────────────────────────────────────────────┘
//!                           ↓
//! ┌─────────────────────────────────────────────────────────┐
//! │ Adapter Layer                                           │
//! │ • Transport Adapters: STDIO ↔ HTTP/SSE ↔ WebSocket     │
//! │ • Protocol Adapters: MCP → REST API / GraphQL          │
//! └─────────────────────────────────────────────────────────┘
//! ```

#![warn(missing_docs)]
#![warn(clippy::all)]
#![warn(clippy::pedantic)]
#![allow(clippy::module_name_repetitions)]

// Public modules
#[cfg(feature = "introspection")]
pub mod introspection;

#[cfg(feature = "runtime")]
pub mod runtime;

#[cfg(feature = "codegen")]
pub mod codegen;

#[cfg(feature = "schema")]
pub mod schema;

pub mod adapters;
pub mod config;
pub mod error;
pub mod proxy;

// Tower middleware integration
#[cfg(feature = "runtime")]
#[cfg_attr(docsrs, doc(cfg(feature = "runtime")))]
pub mod tower;

#[cfg(feature = "cli")]
pub mod cli;

// Re-exports for convenience
pub use error::{ProxyError, ProxyResult};

/// Prelude module for common imports
pub mod prelude {
    pub use crate::config::{BackendConfig, FrontendType};
    pub use crate::error::{ProxyError, ProxyResult};

    #[cfg(feature = "introspection")]
    pub use crate::introspection::{
        McpBackend, McpIntrospector, PromptSpec, ResourceSpec, ServerSpec, StdioBackend, ToolSpec,
    };

    #[cfg(feature = "runtime")]
    pub use crate::runtime::{RuntimeProxy, RuntimeProxyBuilder};

    #[cfg(feature = "codegen")]
    pub use crate::codegen::RustCodeGenerator;

    #[cfg(feature = "rest")]
    pub use crate::adapters::rest::{RestAdapter, RestAdapterConfig};

    #[cfg(feature = "graphql")]
    pub use crate::adapters::graphql::{GraphQLAdapter, GraphQLAdapterConfig};

    // Proxy components
    pub use crate::proxy::{
        AtomicMetrics, BackendConnector, BackendTransport, IdTranslator, ProxyMetrics, ProxyService,
    };

    // Frontend transports
    pub use crate::proxy::frontends::{TcpFrontend, TcpFrontendConfig};
    #[cfg(unix)]
    pub use crate::proxy::frontends::{UnixFrontend, UnixFrontendConfig};
}

/// Version of turbomcp-proxy
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// MCP protocol version supported
pub const MCP_PROTOCOL_VERSION: &str = "2025-11-25";