Skip to main content
Glama
deenesjakoruzh
olostep

olostep-mcp

by olostep
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

MCP-сервер Olostep

Docker Hub Версия npm Лицензия: ISC

Реализация сервера протокола контекста модели (MCP), которая интегрируется с Olostep для веб-скрейпинга, извлечения контента и возможностей поиска. Для настройки MCP-сервера Olostep вам понадобится API-ключ. Вы можете получить его, зарегистрировавшись на сайте Olostep.

Возможности

  • Скрейпинг контента веб-сайтов в форматах HTML, Markdown, JSON или обычного текста (с дополнительными парсерами)

  • Веб-поиск на основе парсеров со структурированными результатами

  • Ответы ИИ с цитатами и опциональным выводом в формате JSON

  • Пакетный скрейпинг до 10 000 URL-адресов

  • Автономный обход сайтов, начиная с заданного URL

  • Обнаружение и отображение URL-адресов веб-сайтов (с фильтрами включения/исключения)

  • Маршрутизация запросов по странам для геотаргетированного контента

  • Настраиваемое время ожидания для сайтов с активным использованием JavaScript

  • Комплексная обработка ошибок и отчетность

  • Простая настройка API-ключа

Related MCP server: mcp-mistral-ocr

Установка

Существует несколько способов подключения к MCP-серверу Olostep. Выберите тот, который лучше всего подходит для вашего рабочего процесса.

☁️ Удаленная конечная точка (рекомендуется)

Самый простой способ — локальная установка не требуется. Подключайтесь напрямую к нашему размещенному MCP-серверу:

https://mcp.olostep.com/mcp

Аутентификация выполняется через токен Bearer в заголовке Authorization с использованием вашего API-ключа Olostep. См. раздел Настройка клиента ниже для примеров конфигурации.

🐳 Docker Hub

Скачайте и запустите официальный образ Docker:

docker pull olostep/mcp-server

docker run -i --rm \
  -e OLOSTEP_API_KEY="your-api-key" \
  olostep/mcp-server

🔧 Локальная сборка Docker

Если вы предпочитаете собирать образ самостоятельно из исходного кода:

git clone https://github.com/olostep/olostep-mcp-server.git
cd olostep-mcp-server
npm install
npm run build
docker build -t olostep/mcp-server:local .

docker run -i --rm -e OLOSTEP_API_KEY="your-api-key" olostep/mcp-server:local

📦 npx

Запуск без установки с помощью npx:

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

В Windows (PowerShell):

$env:OLOSTEP_API_KEY = "your-api-key"; npx -y olostep-mcp

В Windows (CMD):

set OLOSTEP_API_KEY=your-api-key && npx -y olostep-mcp

Или установите глобально:

npm install -g olostep-mcp

Настройка клиента

Cursor

Самый простой способ — использовать удаленную конечную точку. Создайте или отредактируйте файл .cursor/mcp.json в корне вашего проекта:

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Альтернатива (локально): Перейдите в Cursor Settings > Features > MCP Servers, нажмите «+ Add New MCP Server»:

  • Name: olostep

  • Type: command

  • Command: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

Claude Desktop

Добавьте это в ваш claude_desktop_config.json:

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

Альтернатива (Docker):

{
  "mcpServers": {
    "olostep": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "OLOSTEP_API_KEY=YOUR_API_KEY_HERE",
        "olostep/mcp-server"
      ]
    }
  }
}

Или установите через Smithery CLI в терминале вашего устройства:

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

Claude Code

Добавьте удаленную конечную точку в конфигурацию MCP Claude Code:

{
  "mcpServers": {
    "olostep": {
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Альтернатива (локально):

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

Windsurf

Добавьте это в ваш ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "olostep": {
      "serverUrl": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Альтернатива (локально):

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

VS Code

Добавьте это в ваш .vscode/mcp.json:

{
  "servers": {
    "olostep": {
      "type": "http",
      "url": "https://mcp.olostep.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Альтернатива (локально):

{
  "servers": {
    "olostep": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "olostep-mcp"],
      "env": {
        "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Metorial

Вариант 1: Установка в один клик (рекомендуется)

  1. Откройте панель управления Metorial

  2. Перейдите в каталог MCP Servers

  3. Найдите "Olostep"

  4. Нажмите "Install" и введите свой API-ключ

Вариант 2: Ручная настройка

Добавьте это в конфигурацию MCP-сервера Metorial:

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

Инструменты Olostep станут доступны в ваших чатах с ИИ Metorial.

Конфигурация

Переменные окружения

  • OLOSTEP_API_KEY: Ваш API-ключ Olostep (обязательно)

  • ORBIT_KEY: Дополнительный ключ для использования Orbit при маршрутизации запросов.

Доступные инструменты

1. Скрейпинг веб-сайта (scrape_website)

Извлечение контента из одного URL. Поддерживает несколько форматов и рендеринг JavaScript.

{
  "name": "scrape_website",
  "arguments": {
    "url_to_scrape": "https://example.com",
    "output_format": "markdown",
    "country": "US",
    "wait_before_scraping": 1000,
    "parser": "@olostep/amazon-product"
  }
}

Параметры:

  • url_to_scrape: URL веб-сайта, который вы хотите проскрейпить (обязательно)

  • output_format: Выберите формат (html, markdown, json или text) — по умолчанию: markdown

  • country: Дополнительный код страны (например, US, GB, CA) для скрейпинга с учетом местоположения

  • wait_before_scraping: Время ожидания в миллисекундах перед скрейпингом (0-10000)

  • parser: Дополнительный ID парсера для специализированного извлечения

Ответ (пример):

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"id\": \"scrp_...\",\n  \"url\": \"https://example.com\",\n  \"markdown_content\": \"# ...\",\n  \"html_content\": null,\n  \"json_content\": null,\n  \"text_content\": null,\n  \"status\": \"succeeded\",\n  \"timestamp\": \"2025-11-14T12:34:56Z\",\n  \"screenshot_hosted_url\": null,\n  \"page_metadata\": { }\n}"
    }
  ]
}

2. Поиск в Интернете (search_web)

Поиск в Интернете по заданному запросу и получение структурированных результатов (не ИИ, на основе парсера).

{
  "name": "search_web",
  "arguments": {
    "query": "your search query",
    "country": "US"
  }
}

Параметры:

  • query: Поисковый запрос (обязательно)

  • country: Дополнительный код страны для локализованных результатов (по умолчанию: US)

Ответ:

  • Структурированный JSON (в виде текста), представляющий результаты на основе парсера

3. Ответы (ИИ) (answers)

Поиск в Интернете и получение ответов на базе ИИ в нужной вам структуре JSON, с источниками и цитатами.

{
  "name": "answers",
  "arguments": {
    "task": "Who are the top 5 competitors to Acme Inc. in the EU?",
    "json": "Return a list of the top 5 competitors with name and homepage URL"
  }
}

Параметры:

  • task: Вопрос или задача для ответа с использованием веб-данных (обязательно)

  • json: Дополнительная схема/объект JSON или краткое описание желаемой формы вывода

Ответ включает:

  • answer_id, object, task, result (JSON, если предоставлен), sources, created

4. Пакетный скрейпинг URL-адресов (batch_scrape_urls)

Скрейпинг до 10 000 URL-адресов одновременно. Идеально подходит для крупномасштабного извлечения данных.

{
  "name": "batch_scrape_urls",
  "arguments": {
    "urls_to_scrape": [
      {"url": "https://example.com/a", "custom_id": "a"},
      {"url": "https://example.com/b", "custom_id": "b"}
    ],
    "output_format": "markdown",
    "country": "US",
    "wait_before_scraping": 500,
    "parser": "@olostep/amazon-product"
  }
}

Ответ включает:

  • batch_id, status, total_urls, created_at, formats, country, parser, urls

5. Создание обхода (create_crawl)

Автономное обнаружение и скрейпинг целых веб-сайтов путем перехода по ссылкам.

{
  "name": "create_crawl",
  "arguments": {
    "start_url": "https://example.com/docs",
    "max_pages": 25,
    "follow_links": true,
    "output_format": "markdown",
    "country": "US",
    "parser": "@olostep/doc-parser"
  }
}

Ответ включает:

  • crawl_id, object, status, start_url, max_pages, follow_links, created, formats, country, parser

6. Создание карты (create_map)

Получение всех URL-адресов на веб-сайте. Извлечение всех URL для обнаружения и анализа.

{
  "name": "create_map",
  "arguments": {
    "website_url": "https://example.com",
    "search_query": "blog",
    "top_n": 200,
    "include_url_patterns": ["/blog/**"],
    "exclude_url_patterns": ["/admin/**"]
  }
}

Ответ включает:

  • map_id, object, url, total_urls, urls, search_query, top_n

7. Получение контента веб-страницы (get_webpage_content)

Получает контент веб-страницы в чистом формате markdown с поддержкой рендеринга JavaScript.

{
  "name": "get_webpage_content",
  "arguments": {
    "url_to_scrape": "https://example.com",
    "wait_before_scraping": 1000,
    "country": "US"
  }
}

Параметры:

  • url_to_scrape: URL веб-страницы для скрейпинга (обязательно)

  • wait_before_scraping: Время ожидания в миллисекундах перед началом скрейпинга (по умолчанию: 0)

  • country: Страна резидентства для загрузки запроса (например, US, CA, GB) (опционально)

Ответ:

{
  "content": [
    {
      "type": "text",
      "text": "# Example Website\n\nThis is the markdown content of the webpage..."
    }
  ]
}

8. Получение URL-адресов веб-сайта (get_website_urls)

Поиск и получение релевантных URL-адресов с веб-сайта, отсортированных по релевантности вашему запросу.

{
  "name": "get_website_urls",
  "arguments": {
    "url": "https://example.com",
    "search_query": "your search term"
  }
}

Параметры:

  • url: URL веб-сайта для отображения (обязательно)

  • search_query: Поисковый запрос для сортировки URL-адресов (обязательно)

Ответ:

{
  "content": [
    {
      "type": "text",
      "text": "Found 42 URLs matching your query:\n\nhttps://example.com/page1\nhttps://example.com/page2\n..."
    }
  ]
}

9. Получение результатов пакетной обработки (get_batch_results)

Получение результатов ранее отправленного задания пакетного скрейпинга с использованием его batch_id.

{
  "name": "get_batch_results",
  "arguments": {
    "batch_id": "batch_abc123"
  }
}

Ответ включает:

  • batch_id, status (processing или completed), total_urls, completed_urls, items (массив результатов скрейпинга для каждого URL с url, custom_id, markdown_content, html_content, json_content, text_content, status, page_metadata)

Обработка ошибок

Сервер обеспечивает надежную обработку ошибок:

  • Подробные сообщения об ошибках для проблем с API

  • Отчеты о сетевых ошибках

  • Обработка сбоев аутентификации

  • Информация об ограничении скорости (rate limit)

Пример ответа с ошибкой:

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

Распространение

Образы Docker

MCP-сервер доступен в виде образа Docker:

  • Docker Hub: [olostep/mcp-server](https://hub.docker.com/r/olostep/mcp-server)

  • Официальный реестр Docker MCP: mcp/olostep (скоро появится — повышенная безопасность с подписями и SBOM)

  • GitHub Container Registry: ghcr.io/olostep/olostep-mcp-server

Docker Desktop MCP Toolkit

MCP-сервер Olostep добавляется в официальный набор инструментов MCP Toolkit для Docker Desktop, что означает, что пользователи смогут:

  • Обнаруживать его в пользовательском интерфейсе MCP Toolkit в Docker Desktop

  • Устанавливать его в один клик

  • Настраивать его визуально

  • Использовать его с любым MCP-совместимым клиентом (Claude Desktop, Cursor и т.д.)

Статус: Заявка на добавление в Docker MCP Registry находится на рассмотрении

Поддерживаемые платформы

  • linux/amd64

  • linux/arm64

Локальная сборка

# Clone the repository
git clone https://github.com/olostep/olostep-mcp-server.git
cd olostep-mcp-server

# Build the image
npm install
npm run build
docker build -t olostep/mcp-server .

# Run locally
docker run -i --rm -e OLOSTEP_API_KEY="your-key" olostep/mcp-server

Лицензия

Лицензия ISC

Install Server
A
security – no known vulnerabilities
A
license - permissive license
B
quality - B tier

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/olostep/olostep-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server