{"type":"mcp_server","name":"oxylabs-mcp","description":"This repository provides an MCP server that allows AI assistants to access web data through Oxylabs' web scraping technology, enabling them to scrape, render, and extract content while bypassing anti-scraping measures.","category":"AI","language":"Python","stars":100,"forks":2,"owner":"oxylabs","github_url":"https://github.com/oxylabs/oxylabs-mcp","homepage":null,"setup":"## Setup\n\n### Install via Smithery (Recommended)\n\nAutomatically install Oxylabs MCP server for Claude Desktop via [Smithery](https://smithery.ai/server/@oxylabs/oxylabs-mcp):\n\n```bash\nnpx -y @smithery/cli install @oxylabs/oxylabs-mcp --client claude\n```\n---\n### Run on Cursor\n\n> [!IMPORTANT]\n> Requires Cursor version `0.45.6+`\n\nTo configure Oxylabs in Cursor:\n\n1.  Open Cursor **Settings**\n2.  Go to **Features > MCP Servers**\n3.  Click \"**+ Add New MCP Server**\"\n4.  Enter the following:\n    *   **Name**: `oxylabs` (or your preferred name)\n    *   **Type**: `command`\n    *   **Command**:`npx -y @smithery/cli@latest run @oxylabs/oxylabs-mcp --config \"{\\\"oxylabsUsername\\\":\\\"YOUR_USERNAME\\\",\\\"oxylabsPassword\\\":\\\"YOUR_PASSWORD\\\"}\"`\n\nReplace `your-username` and `your-password` with your Oxylabs credentials.\n\n> [!TIP]\n> If you're using Windows and run into issues, try this:\n> \n> `cmd /c \"set OXYLABS_USERNAME=your-username && set OXYLABS_PASSWORD=your-password && npx -y oxylabs-mcp\"`\n\nAfter that, refresh the MCP server list to see the new tools. The Composer Agent will automatically use Oxylabs when appropriate, but you can explicitly request it by describing your web scraping needs. Access the Composer via `Command+L` (Mac), select \"Agent\" next to the submit button, and enter your query.\n\n---\n### Set up with Claude Desktop\n\nEnable **Developer Mode** and then navigate to **Claude → Settings → Developer → Edit Config** and edit your `claude_desktop_config.json` file as follows:\n\n```json\n{\n  \"mcpServers\": {\n    \"oxylabs_scraper\": {\n      \"command\": \"uvx\",\n      \"args\": [\"oxylabs-mcp\"],\n      \"env\": {\n        \"OXYLABS_USERNAME\": \"YOUR_USERNAME_HERE\",\n        \"OXYLABS_PASSWORD\": \"YOUR_PASSWORD_HERE\"\n      }\n    }\n  }\n}\n```\n---\n\n## 💻 Local/Dev Setup Instructions\n\n### Clone repository\n\n```\ngit clone <git:url>\n```\n\n### Install dependencies\n\nInstall MCP server dependencies:\n\n```bash\ncd mcp-server-oxylabs\n\n# Create virtual environment and activate it\nuv venv\n\nsource .venv/bin/activate # MacOS/Linux\n# OR\n.venv/Scripts/activate # Windows\n\n# Install dependencies\nuv sync\n```\n\n### Setup with Claude Desktop\n\nEnable **Developer Mode** and then navigate to **Claude → Settings → Developer → Edit Config** and edit your `claude_desktop_config.json` file as follows:\n\n```json\n{\n  \"mcpServers\": {\n    \"oxylabs_scraper\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/<Absolute-path-to-folder>/oxylabs-mcp\",\n        \"run\",\n        \"oxylabs-mcp\"\n      ],\n      \"env\": {\n        \"OXYLABS_USERNAME\": \"YOUR_USERNAME_HERE\",\n        \"OXYLABS_PASSWORD\": \"YOUR_PASSWORD_HERE\"\n      }\n    }\n  }\n}\n```\n---\n### 🐞 Debugging\n\n```bash\nmake run\n```\nThen access MCP Inspector at `http://localhost:5173`. You may need to add your username and password as environment variables in the inspector under `OXYLABS_USERNAME` and `OXYLABS_PASSWORD`.","tools":"## Available Tools\n\n1.  Scrape content from any site (Extract data from any URL, including complex single-page applications).\n2.  Automatically get AI-ready data (Automatically clean and convert HTML to Markdown for improved readability).\n3.  Bypass blocks & geo-restrictions (Bypass sophisticated bot protection systems with high success rate).\n4.  Flexible setup & cross-platform support (Set rendering and parsing options if needed).\n5.  Built-in error handling and request management (Comprehensive error handling and reporting).\n6.  oxylabs_scraper (Uses Oxylabs Web Scraper API for general website scraping).\n7.  oxylabs_web_unblocker (Uses Oxylabs Web Unblocker for hard-to-access websites).","faq":null,"created_at":"2025-01-17T13:47:05+00:00","updated_at":"2025-03-28T17:21:53+00:00","source_url":"https://model-context-protocol.com/servers/ai-web-scraping-oxylabs-data-access","related_articles":[]}