Cdreetz/mcp env v2

[cdreetz]

Description

• new MCPEnv that supports stdio, remote http, sandboxed http, synthetic transports
• new verifiers/utils/mcp_utils/ that includes mcp utils and transports

Details

• transports are an interface for creating and using mcp servers with environments
• a base transport defines the basic methods needed by a transport, with the 2 main being stdio and http
• the sandbox transport is an extension of the http transport given it is still running streamable http mcp just with some extra steps and additional resource management
• during initialization of a transport a client session connected to the server is created and the list of tools available from the server

class MCPTransport(ABC):
    """Base transport for MCP connections."""

    @abstractmethod
    async def connect(self) -> Dict[str, Tool]:
        """Connect and return available tools."""
        pass

    @abstractmethod
    async def call_tool(self, tool_name: str, arguments: dict) -> str:
        """Execute a tool call"""
        pass

    @abstractmethod
    async def disconnect(self) -> None:
        """Cleanup connection"""
        pass

    @abstractmethod
    async def is_connected(self) -> bool:
        """Check connection status"""
        pass

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Test improvement

Testing

• All existing tests pass when running uv run pytest locally.
• New tests have been added to cover the changes

Checklist

• My code follows the style guidelines of this project as outlined in AGENTS.md
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• Any dependent changes have been merged and published

Additional Notes