MCPServerConfig¶

Configuration for MCP servers.

Quick Example¶

from mamba_agents.mcp import MCPServerConfig, MCPAuthConfig

# Stdio transport
config = MCPServerConfig(
    name="filesystem",
    transport="stdio",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-filesystem", "/path"],
)

# SSE transport with auth
config = MCPServerConfig(
    name="api",
    transport="sse",
    url="http://localhost:8080/sse",
    auth=MCPAuthConfig(
        type="api_key",
        key_env="API_KEY",
    ),
)

Configuration Options¶

MCPServerConfig¶

Option	Type	Description
`name`	str	Unique server name
`transport`	str	`"stdio"` or `"sse"`
`command`	str	Command (stdio)
`args`	list	Arguments (stdio)
`url`	str	Server URL (sse)
`auth`	MCPAuthConfig	Authentication
`tool_prefix`	str	Prefix for tools
`env_file`	str	Path to .env file
`env_vars`	dict	Environment variables

MCPAuthConfig¶

Option	Type	Description
`type`	str	`"api_key"`
`key`	str	Direct key
`key_env`	str	Env var name
`header`	str	HTTP header

API Reference¶

MCPServerConfig ¶

Bases: BaseModel

Configuration for an MCP server.

Supports stdio (subprocess), SSE (HTTP), and Streamable HTTP transports.

ATTRIBUTE	DESCRIPTION
`name`	Unique server name. TYPE: `str`
`transport`	Transport type (stdio, sse, or streamable_http). TYPE: `Literal['stdio', 'sse', 'streamable_http']`
`command`	Command to run (stdio transport). TYPE: `str \| None`
`args`	Command arguments (stdio transport). TYPE: `list[str]`
`url`	Server URL (SSE or Streamable HTTP transport). TYPE: `str \| None`
`auth`	Authentication configuration. TYPE: `MCPAuthConfig \| None`
`tool_prefix`	Prefix for tool names from this server. TYPE: `str \| None`
`env_file`	Path to .env file for environment variables. TYPE: `str \| Path \| None`
`env_vars`	Environment variables (highest precedence). TYPE: `dict[str, str] \| None`
`timeout`	Initialization timeout in seconds (default: 30). TYPE: `float`
`read_timeout`	Read timeout for long-lived connections in seconds (default: 300). TYPE: `float`

MCPAuthConfig ¶

Bases: BaseModel

Authentication configuration for MCP servers.

ATTRIBUTE	DESCRIPTION
`type`	Authentication type (currently only api_key supported). TYPE: `Literal['api_key']`
`key_env`	Environment variable name containing the API key. TYPE: `str \| None`
`key`	Direct key value or env var reference (${VAR_NAME}). TYPE: `str \| None`
`header`	HTTP header name for the key. TYPE: `str`