Daytona icon

Daytona MCP Server

Fast and secure execution of your AI generated code with sandboxes

Official Active High Popularity 35.41 stars/day Updated 2 days ago
View on Github

Daytona MCP (Model Context Protocol) Server

Daytona MCP Server allows AI agents to utilize:

  • Daytona Sandbox Management (Create, Destroy)
  • Execute commands in Daytona Sandboxes
  • File Operations in Daytona sandboxes
  • Generate preview links for web applications running in Daytona Sandboxes

Prerequisites

  • Daytona account
  • Daytona CLI installed
  • A compatible AI agent (Claude Desktop App, Claude Code, Cursor, Windsurf)

Steps to Integrate Daytona MCP Server with an AI Agent

  1. Install the Daytona CLI:

Mac/Linux

brew install daytonaio/cli/daytona

Windows

powershell -Command "irm https://get.daytona.io/windows | iex"
  1. Log in to your Daytona account:
daytona login
  1. Initialize the Daytona MCP server with Claude Desktop/Claude Code/Cursor/Windsurf:
daytona mcp init [claude/cursor/windsurf]
  1. Open Agent App

Integrating with Other AI Agents Apps

Run the following command to get a JSON Daytona MCP configuration which you can c/p to your agent configuration:

daytona mcp config

Command outputs the following:

{
  "mcpServers": {
    "daytona-mcp": {
      "command": "daytona",
      "args": ["mcp", "start"],
      "env": {
        "HOME": "${HOME}",
        "PATH": "${HOME}:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin"
      },
      "logFile": "${HOME}/Library/Logs/daytona/daytona-mcp-server.log"
    }
  }
}

Note: if you are running Daytona MCP Server on Windows OS, add the following to the env field of the configuration:

"APPDATA": "${APPDATA}"

Finally, open or restart your AI agent

Available Tools

Sandbox Management

  • create_sandbox: Create a new sandbox with Daytona

    • Parameters:
      • id (optional): Sandbox ID - if provided, an existing sandbox will be used, new one will be created otherwise
      • target (default: "us"): Target region of the sandbox
      • image: Image of the sandbox (optional)
      • auto_stop_interval (default: "15"): Auto-stop interval in minutes (0 means disabled)
      • auto_archive_interval (default: "10080"): Auto-archive interval in minutes (0 means the maximum interval will be used)
      • auto_delete_interval (default: "-1"): Auto-delete interval in minutes (negative value means disabled, 0 means delete immediately upon stopping)

  • destroy_sandbox: Destroy a sandbox with Daytona

File Operations

  • upload_file: Upload a file to the Daytona sandbox

    • Files can be text or base64-encoded binary content
    • Creates necessary parent directories automatically
    • Files persist during the session and have appropriate permissions
    • Supports overwrite controls and maintains original files formats
    • Parameters:
      • id (optional): Sandbox ID
      • file_path: Path to the file to upload
      • content: Content of the file to upload
      • encoding: Encoding of the file to upload
      • overwrite: Overwrite the file if it already exists

  • download_file: Download a file from the Daytona sandbox

    • Returns file content as text or base64 encoded image
    • Handles special cases like matplotlib plots stored as JSON
    • Parameters:
      • id (optional): Sandbox ID
      • file_path: Path to the file to download

  • create_folder: Create a new folder in the Daytona sandbox

    • Parameters:
      • id (optional): Sandbox ID
      • folder_path: Path to the folder to create
      • mode: Mode of the folder to create (defaults to 0755)

  • get_file_info: Get information about a file in the Daytona sandbox

    • Parameters:
      • id (optional): Sandbox ID
      • file_path: Path to the file to get information about

  • list_files: List files in a directory in the Daytona sandbox

    • Parameters:
      • id (optional): Sandbox ID
      • path: Path to the directory to list files from (defaults to current directory)

  • move_file: Move or rename a file in the Daytona sandbox

    • Parameters:
      • id (optional): Sandbox ID
      • source_path: Source path of the file to move
      • dest_path: Destination path where to move the file

  • delete_file: Delete a file or directory in the Daytona sandbox

    • Parameters:
      • id (optional): Sandbox ID
      • file_path: Path to the file or directory to delete

Git Operations

  • git_clone: Clone a Git repository into the Daytona sandbox

    • Parameters:
      • id (optional): Sandbox ID
      • url: URL of the Git repository to clone
      • path: Directory to clone the repository into (defaults to current directory)
      • branch: Branch to clone
      • commit_id: Commit ID to clone
      • username: Username to clone the repository with
      • password: Password to clone the repository with

Command Execution

  • execute_command: Execute shell commands in the ephemeral Daytona Linux environment

    • Returns full stdout and stderr output with exit codes
    • Commands have sandbox user permissions
    • Parameters:
      • id (optional): Sandbox ID
      • command: Command to execute

Preview

  • preview_link: Generate accessible preview URLs for web applications running in the Daytona sandbox

    • Creates a secure tunnel to expose local ports externally without configuration
    • Validates if a server is actually running on the specified port
    • Provides diagnostic information for troubleshooting
    • Supports custom descriptions and metadata for better organization of multiple services
    • Parameters:
      • id (optional): Sandbox ID
      • port: Port to expose
      • description: Description of the service
      • check_server: Check if a server is running

Troubleshooting

  • Authentication issues: Run daytona login to refresh your credentials
  • Connection errors: Ensure that the Daytona MCP Server is properly configured
  • Sandbox errors: Check sandbox status with daytona sandbox list

Support

For more information, visit daytona.io or contact support at support@daytona.io.