Enum McpServerConfig 

pub enum McpServerConfig {
    Stdio(StdioServerConfig),
    Remote(RemoteServerConfig),
    InMemory(InMemoryServerConfig),
}

A single MCP server. The type field selects the transport; stdio is the default and may be omitted.

A local stdio server launched as a subprocess:

{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": { "GITHUB_TOKEN": "ghp_..." }
}

A remote streamable-HTTP server using a pre-registered public OAuth client:

{
  "type": "http",
  "url": "https://mcp.slack.com/mcp",
  "oauth": {
    "clientId": "1601185624273.8899143856786",
    "callbackPort": 3118
  }
}

When a remote HTTP server returns an OAuth challenge, Aether uses its first-party Client ID Metadata Document at https://aether-agent.io/oauth/client-metadata.json and listens on 127.0.0.1:3118, advertising the exact redirect URI http://localhost:3118/. If port 3118 is occupied, authentication fails until the port is available.

The oauth object is optional. Set clientMetadataUrl for a custom CIMD, or clientId for a pre-registered public client; a configured clientId takes priority. callbackPort defaults to 3118 and must exactly match the client’s registered redirect URI. If the authorization server does not advertise CIMD, Aether falls back to deprecated Dynamic Client Registration. An Authorization header on its own turns off OAuth.

A server can configure one of oauth, sigv4, or an Authorization header. For example:

{
  "type": "http",
  "url": "https://abc123.execute-api.us-east-1.amazonaws.com/mcp",
  "sigv4": { "service": "execute-api", "region": "us-east-1", "profile": "dev" }
}

A remote server using a bearer token:

{
  "type": "http",
  "url": "https://mcp.example.com",
  "headers": { "Authorization": "Bearer ..." }
}

Set "deferTools": true to omit every tool on this server from the model-visible tool definitions and make it available through progressive aether mcp discovery. For selective deferral, set deferTools to an object with include and exclude lists. Entries match either an exact MCP-local tool name or a prefix ending in *:

{
  "type": "in-memory",
  "deferTools": {
    "include": ["*"],
    "exclude": ["bash", "lsp_*"]
  }
}

Variants

Stdio(StdioServerConfig)

Remote(RemoteServerConfig)

InMemory(InMemoryServerConfig)

Implementations

impl McpServerConfig

pub fn defer_tools(&self) -> &ToolExposure

Trait Implementations

impl Clone for McpServerConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for McpServerConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for McpServerConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for McpServerConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for McpServerConfig

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for McpServerConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for McpServerConfig