Servidor MCP de Olostep

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que se integra con Olostep para el web scraping, la extracción de contenido y las funciones de búsqueda. Para configurar el Servidor MCP de Olostep, necesita una clave API. Puede obtenerla registrándose en el sitio web de Olostep .

Características

• Extracción de contenido de páginas web con formato Markdown limpio

• Resultados de búsqueda de Google con extracción de datos estructurados

• Descubrimiento y mapeo de URL de sitios web

• Enrutamiento de solicitudes específicas de cada país para contenido geolocalizado

• Tiempos de espera configurables para sitios web con mucho JavaScript

• Gestión y generación de informes de errores integrales

• Configuración sencilla de clave API

Related MCP server: mcp-mistral-ocr

Instalación

Ejecutando con npx

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

Instalación manual

npm install -g olostep-mcp

Ejecutándose en Claude Desktop

Agregue esto a su claude_desktop_config.json :

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

O para una forma más sencilla, puede instalarlo a través de la CLI de Smithery ejecutando el siguiente código en la terminal de su dispositivo.

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

Corriendo en Windsurf

Agregue esto a su ./codeium/windsurf/model_config.json :

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

Ejecutando en el cursor

Para configurar Olostep MCP en Cursor:

1. Abrir configuración del cursor

2. Vaya a Características > Servidores MCP

3. Haga clic en "+ Agregar nuevo servidor MCP"

4. Introduzca lo siguiente:

   • Nombre: "olostep-mcp" (o el nombre que prefiera)

   • Tipo: "comando"

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

Reemplace your-api-key con su clave API de Olostep.

Configuración

Variables de entorno

• OLOSTEP_API_KEY : Su clave API de Olostep (obligatoria)

Herramientas disponibles

1. Obtener el contenido de la página web ( get_webpage_content )

Recupera el contenido de la página web en formato Markdown limpio con soporte para renderizado de JavaScript.

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

Parámetros:

• url_to_scrape : La URL de la página web a raspar (obligatorio)

• wait_before_scraping : Tiempo de espera en milisegundos antes de iniciar el raspado (predeterminado: 0)

• country : País de residencia desde el cual cargar la solicitud (por ejemplo, EE. UU., CA, GB) (opcional)

Respuesta:

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

2. Obtener las URL del sitio web ( get_website_urls )

Busque y recupere URL relevantes de un sitio web, ordenadas por relevancia para su consulta.

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

Parámetros:

• url : La URL del sitio web a mapear (obligatorio)

• search_query : La consulta de búsqueda para ordenar las URL (obligatorio)

Respuesta:

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

3. Búsqueda de Google ( google_search )

Recupere datos estructurados de los resultados de búsqueda de Google.

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

Parámetros:

• query : La consulta de búsqueda a realizar (obligatorio)

• country : código de país para resultados localizados (p. ej., EE. UU., GB) (predeterminado: "EE. UU.")

La respuesta incluye:

• Resultados de búsqueda orgánicos con títulos, enlaces y fragmentos

• Datos del gráfico de conocimiento cuando estén disponibles

• Preguntas relacionadas (La gente también pregunta)

• Búsquedas relacionadas

• Fragmentos enriquecidos y otros datos estructurados

Manejo de errores

El servidor proporciona un manejo robusto de errores:

• Mensajes de error detallados para problemas de API

• Informe de errores de red

• Manejo de fallos de autenticación

• Información sobre el límite de velocidad

Ejemplo de respuesta de error:

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

Licencia

Licencia ISC