agentsphere-mcp-server

# PTY Create Function for MCP Server This implementation provides a cross-platform `pty_create(sandbox_id: str)` function for MCP (Model Context Protocol) servers, enabling terminal interaction with sandboxes. ## Features - ✅ **Cross-platform support**: Works on macOS and Windows - ✅ **Optional sandbox_id parameter**: Reuse existing sandboxes or create new ones - ✅ **MCP protocol integration**: Full server/client implementation - ✅ **Async/await support**: Non-blocking terminal operations - ✅ **Session management**: Create, manage, and close multiple terminal sessions - ✅ **Backward compatibility**: Works even without agentsphere package ## Installation ```bash # Install basic dependencies pip install -r requirements.txt # Install agentsphere for full functionality (optional) pip install agentsphere ``` ## Quick Start ### Basic Usage ```python from pty_create import pty_create, get_terminal_session # Create a new PTY session session_id = pty_create() print(f"Session ID: {session_id}") # Get session object session = get_terminal_session(session_id) # Write to terminal session.write(b"ls -la\n") # Read from terminal output = await session.read() print(f"Output: {output}") # Close session await close_terminal_session(session_id) ``` ### With Specific Sandbox ```python # Create PTY session with specific sandbox session_id = pty_create("sandbox_123") ``` ### Simple Terminal Mode (without agentsphere) The function works even without the agentsphere package, providing a simple terminal interface: ```python # This will work even without agentsphere session_id = pty_create() session = get_terminal_session(session_id) ``` ## MCP Server Integration ### Running the Server ```bash # Start the MCP server python examples/server_example.py server ``` ### Client Connection ```python from mcp_terminal import MCPClient # Connect to server client = MCPClient(host="localhost", port=8001) await client.connect() # Create session session_id = await client.pty_cre…