Olostep Olostep MCP Server

🚀 Olostep MCP Server

An implementation of the Model Context Protocol (MCP) server integrated into Olostep, designed for web crawling, content extraction, and search functionality.

To set up the Olostep MCP Server, you need an API key. You can register on the Olostep website to obtain this key.

✨ Features

• Extract web page content in clean Markdown format.
• Extract structured data from Google search results.
• Discover and map website URLs.
• Support request routing by country/region for geolocated content.
• Configurable waiting time for JavaScript-intensive websites.
• Comprehensive error handling and reporting.
• Simple API key configuration.

📦 Installation

Run with npx

env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

Manual Installation

npm install -g olostep-mcp

Run on Claude Desktop

Add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "mcp-server-olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Alternatively, install more directly via the Smithery CLI:

npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude

Run on Windsurf

Add the following to your ./codeium/windsurf/model_config.json file:

{
  "mcpServers": {
    "mcp-server-olostep": {
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Run on Cursor

Add the following to your ~/.config/cursor file:

npx olostep-mcp --set-global

Environment Variables

export OLOSTEP_API_KEY="your-api-key"

💻 Usage Examples

Basic Usage

Get Web Page Content

Retrieve web page content from the terminal using the following command:

npx olostep-mcp get-content https://example.com

Extract URLs

Extract all links from the target website:

npx olostep-mcp extract-urls https://example.com

Search Functionality

Search for keywords and get results:

npx olostep-mcp search "your-query"

🔧 Technical Details

Error Handling

The server provides robust error handling capabilities, including detailed error messages, network error reports, authentication failure handling, and rate limit information.

Example error response:

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Olostep API error: 401 Unauthorized. Details: {\"error\":\"Invalid API key\"}"
    }
  ]
}

📄 License

This project is licensed under the ISC License.