Glama
Sign In

Scrapybara MCP

by Scrapybara
GitHub
JavaScript
MIT License
9
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Supports using OpenAI's models for the ACT feature, allowing an agent to control a Scrapybara instance using natural language instructions.

  • Provides virtual Ubuntu desktop instances that can be controlled via the MCP, enabling browsing, running code, and other desktop operations.

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

Installation

  1. Clone the repository:
git clone https://github.com/scrapybara/scrapybara-mcp.git cd scrapybara-mcp
  1. Install dependencies:
pnpm install
  1. Build the project:
pnpm build
  1. Add the following to your MCP client config:
{ "mcpServers": { "scrapybara-mcp": { "command": "node", "args": ["path/to/scrapybara-mcp/dist/index.js"], "env": { "SCRAPYBARA_API_KEY": "<YOUR_SCRAPYBARA_API_KEY>", "ACT_MODEL": "<YOUR_ACT_MODEL>", // "anthropic" or "openai" "AUTH_STATE_ID": "<YOUR_AUTH_STATE_ID>" // Optional, for authenticating the browser } } } }
  1. 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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. Installation
    1. Tools
      1. Contributing

        Related Resources