Official Oxylabs MCP integration
The scraper tool is an asynchronous utility that leverages the Oxylabs Web Scraper API to fetch and process content from a given URL. This tool is designed to handle various scraping scenarios efficiently, with flexible options for parsing and rendering web pages.
https://docs.astral.sh/uv/getting-started/installation/#installation-methods
To install Oxylabs MCP server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @oxylabs/oxylabs-mcp --client claude
Configuring Cursor 🖥️ Note: Requires Cursor version 0.45.6+
To configure Oxylabs in Cursor:
npx -y @smithery/cli@latest run @oxylabs/oxylabs-mcp --config "{\"oxylabsUsername\":\"YOUR_USERNAME\",\"oxylabsPassword\":\"YOUR_PASSWORD\"}"If you are using Windows and are running into issues, try
cmd /c "set OXYLABS_USERNAME=your-username && set OXYLABS_PASSWORD=your-password && npx -y oxylabs-mcp"
Replace your-username and your-password with your Oxylabs credentials.
After adding, 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.
## claude_desktop_config.json
## Can find location through:
## Claude -> Settings -> Developer -> Edit Config
{
"mcpServers": {
"oxylabs_scraper": {
"command": "uvx",
"args": ["oxylabs-mcp"],
"env": {
"OXYLABS_USERNAME": "YOUR_USERNAME_HERE",
"OXYLABS_PASSWORD": "YOUR_PASSWORD_HERE"
}
}
}
}
git clone <git:url>
Install MCP server dependencies:
cd mcp-server-oxylabs
## Create virtual environment and activate it
uv venv
source .venv/bin/activate # MacOS/Linux
## OR
.venv/Scripts/activate # Windows
## Install dependencies
uv sync
## claude_desktop_config.json
## Can find location through:
## Claude -> Settings -> Developer -> Edit Config
{
"mcpServers": {
"oxylabs_scraper": {
"command": "uv",
"args": [
"--directory",
"/<Absolute-path-to-folder>/oxylabs-mcp",
"run",
"oxylabs-mcp"
],
"env": {
"OXYLABS_USERNAME": "YOUR_USERNAME_HERE",
"OXYLABS_PASSWORD": "YOUR_PASSWORD_HERE"
}
}
}
}
Run:
make run
Then access MCP Inspector at http://localhost:5173. You may need to add your username and password in the environment variables in the inspector under OXYLABS_USERNAME and OXYLABS_PASSWORD.
NOTE
Usage with the MCP inspector is affected by an ongoing issue with the Python SDK for MCP, see: https://github.com/modelcontextprotocol/python-sdk/pull/85. For Claude, a forked version of the SDK is used as a temporary fix.
This project is licensed under the MIT License{:target=“_blank”}.
Established in 2015, Oxylabs are a market-leading web intelligence collection platform, driven by the highest business, ethics, and compliance standards, enabling companies worldwide to unlock data-driven insights.
An MCP server for accessing data from Data.gov, providing tools and resources for interacting with government datasets.
An MCP server enhances AI responses with real-time search results via Higress ai-search.
An MCP server that provides tools for retrieving and processing documentation through vector search, both locally or hosted. Enabling AI assistants to augment their responses with relevant documentation context.
Obsidian Knowledge-Management MCP (Model Context Protocol) server that enables AI agents and development tools to interact with an Obsidian vault. It provides a comprehensive suite of tools for reading, writing, searching, and managing notes, tags, and frontmatter, acting as a bridge to the Obsidian Local REST API plugin.
