MCP Module

Model Context Protocol integration.

Classes

Class	Description
MCPClientManager	Manage MCP server connections
MCPServerConfig	Server configuration

Functions

Function	Description
load_mcp_json	Load configs from .mcp.json file

Exceptions

Exception	Description
MCPConfigError	Base MCP configuration error
MCPFileNotFoundError	Config file not found
MCPFileParseError	Invalid JSON in config
MCPServerValidationError	Invalid server entry

Quick Example

from mamba_agents import Agent
from mamba_agents.mcp import MCPClientManager, MCPServerConfig

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

manager = MCPClientManager(configs)
agent = Agent("gpt-4o", toolsets=manager.as_toolsets())
result = await agent.run("List files")

Loading from .mcp.json

from mamba_agents.mcp import MCPClientManager

# Load from Claude Desktop compatible format
manager = MCPClientManager.from_mcp_json(".mcp.json")
agent = Agent("gpt-4o", toolsets=manager.as_toolsets())

Imports

from mamba_agents.mcp import (
    # Manager and config
    MCPClientManager,
    MCPServerConfig,
    MCPAuthConfig,
    # Loader
    load_mcp_json,
    # Exceptions
    MCPConfigError,
    MCPFileNotFoundError,
    MCPFileParseError,
    MCPServerValidationError,
)