The Scrapybara MCP server allows clients to interact with virtual Ubuntu desktops for web browsing, code execution, and more.
- Start an instance: Launch a Scrapybara Ubuntu desktop sandbox and get a stream URL for real-time viewing.
- Get instances: Retrieve all running Scrapybara instances.
- Stop an instance: Terminate a specific instance using its ID.
- Run bash commands: Execute shell commands in a specified instance.
- Act on instances: Control an instance through an agent that can perform mouse/keyboard actions and execute commands based on prompts, with optional structured output.
A Model Context Protocol server for Scrapybara. This server enables MCP clients such as Claude Desktop, Cursor, and Windsurf to interact with virtual Ubuntu desktops and take actions such as browsing the web, running code, and more.
Prerequisites
- Node.js 18+
- pnpm
- Scrapybara API key (get one at scrapybara.com)
Installation
- Clone the repository:
- Install dependencies:
- Build the project:
- Add the following to your MCP client config:
- Restart your MCP client and you're good to go!
Tools
- start_instance - Start a Scrapybara Ubuntu instance. Use it as a desktop sandbox to access the web or run code. Always present the stream URL to the user afterwards so they can watch the instance in real time.
- get_instances - Get all running Scrapybara instances.
- stop_instance - Stop a running Scrapybara instance.
- bash - Run a bash command in a Scrapybara instance.
- act - Take action on a Scrapybara instance through an agent. The agent can control the instance with mouse/keyboard and bash commands.
Contributing
Scrapybara MCP is a community-driven project. Whether you're submitting an idea, fixing a typo, adding a new tool, or improving an existing one, your contributions are greatly appreciated!
Before contributing, read through the existing issues and pull requests to see if someone else is already working on something similar. That way you can avoid duplicating efforts.
If there are more tools or features you'd like to see, feel free to suggest them on the issues page.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that enables AI clients to interact with virtual Ubuntu desktops, allowing them to browse the web, run code, and control instances through mouse/keyboard actions and bash commands.
Related Resources
Related MCP Servers
- -securityFlicense-qualityA server that provides rich UI context and interaction capabilities to AI models, enabling deep understanding of user interfaces through visual analysis and precise interaction via Model Context Protocol.Last updated -53Python
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -61TypeScript
302AI BrowserUse MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol server that enables Claude Desktop to browse the web, likely allowing the AI to access and interact with web content.Last updated -2115JavaScriptMIT License- -securityFlicense-qualityA Model Context Protocol server that extends AI capabilities through tools for remote control, note-taking, email operations, and knowledge search.Last updated -Python