automationtypescript

Ashra MCP

Headless browser control with screenshot capabilities - Ashra integration for enhanced AI capabilities

View on GitHub
385

GitHub Stars

Last Updated2 months ago
Languagetypescript

🚀 Installation & Setup

Quick Install

# Clone the repository
git clone https://github.com/getrupt/ashra-mcp
cd ashra-mcp

# Install dependencies
npm install

# Build and run
npm run build
npm start

Prerequisites

  • Node.js 18+ or Python 3.8+ (depending on implementation)
  • MCP-compatible client (Claude Desktop, Continue, etc.)
  • Basic understanding of Model Context Protocol

⚙️ Configuration

MCP Settings Configuration

{
  "mcpServers": {
    "ashra-mcp": {
      "command": "node",
      "args": ["path/to/ashra-mcp/dist/index.js"],
      "env": {
        "API_KEY": "your-api-key-here",
        "DEBUG": "false"
      }
    }
  }
}

Environment Variables

Set these environment variables based on your needs:

  • • API_KEY - Your API key (if required)
  • • DEBUG_MODE - Enable debug logging
  • • TIMEOUT - Request timeout in seconds

💡 Usage Examples

Basic Usage

// Example: Automate browser actions
const page = await mcpClient.callTool('navigate', {
  url: 'https://example.com',
  waitFor: 'networkidle'
});

const data = await mcpClient.callTool('extract', {
  selector: '.product-info',
  attributes: ['title', 'price']
});

Integration Guide

This MCP server can be integrated into various AI applications and workflows. Check the GitHub repository for detailed integration examples and API documentation.

View Documentation

📊 Quick Stats

Categoryautomation
Languagetypescript
RepositoryGitHub →

👥 Contributors

getrupt1 contributions

❓ FAQ

Which browsers are supported?
Most automation servers support Chrome, Firefox, Safari, and Edge. Headless modes are available for better performance.
How do I handle dynamic content?
Use wait conditions and element selectors to handle dynamically loaded content. Most servers provide smart waiting mechanisms.
Can I run tests in parallel?
Yes, many automation servers support parallel execution to speed up test runs and improve efficiency.

More automation MCP Tools