Si ya construiste tu primer MCP server y te quedaste con ganas de más, aquí aprenderás a ampliar tu MCP server con herramientas de SERP API: noticias, productos, preguntas y respuestas, además de un recurso para documentar todo automáticamente. Es ideal para desarrolladores que quieren conectar búsquedas web con un LLM sin llamar directo a la API.
La idea central es sencilla pero poderosa: una vez que tienes la estructura base de una herramienta, el resto es repetir el patrón y cambiar solo el endpoint que consultas. Y aquí viene lo interesante, porque SERP API ofrece una cantidad casi infinita de servicios que puedes tomar prestados para tu servidor.
Qué servicios de SERP API puedes integrar a tu MCP
En la clase anterior usamos la Google Search Engine Results API, pero la cuenta de SERP API tiene mucho más que eso. Al revisar la pantalla aparecen discusiones y foros, resultados comerciales y decenas de opciones más.
De toda esa oferta, hay cuatro que destacan para construir un servidor más capaz:
- Búsqueda de noticias, útil si usas lectores de feeds como Feedly o dev.to.
- Búsqueda de productos, con intención de compra (shopping intent).
- Preguntas y respuestas (Q&A), para respuestas directas.
- Un recurso para generar documentación en markdown.
¿Qué es un MCP server? Es un servidor que expone herramientas para que un cliente o un LLM las consuma. En este caso integra búsquedas web mediante SERP API, de modo que el cliente no tiene que llamar a la API directamente.
Cada herramienta comparte la misma base, así que una vez entiendes una, entiendes todas [00:48].
Cómo agregar la herramienta de búsqueda de noticias
La primera herramienta nueva busca los artículos más recientes relacionados con tu consulta. Lo valioso es que replica exactamente la sección de parámetros de la herramienta anterior [01:16].
Los parámetros son tres:
- La consulta, es decir, qué estás buscando.
- Cuántos elementos quieres recuperar.
- El contexto, donde se guarda esa consulta.
Después de guardar la consulta en el contexto, se ejecuta make SERP API request con el contexto y los parámetros. El resultado puede venir vacío o con artículos, y en ese caso se formatea para mostrar la fuente, la fecha, el enlace y un pequeño resumen [01:47]. La fecha es un dato clave cuando trabajas con noticias.
Cómo implementar la búsqueda de productos
La búsqueda de productos es prácticamente un copiar y pegar de la herramienta de noticias [02:33]. Mismos parámetros, mismo contexto, con la diferencia de que consulta la parte de shopping intent.
Al ejecutarse, devuelve los productos con su formato correspondiente o, si no hay coincidencias, una excepción controlada. En la prueba con "Surface Laptop" aparecieron precios como 859, 1.300 y 469 dólares, aunque los enlaces salieron como no link, señal de que ese método todavía se puede refinar.
Por qué la herramienta de Q&A es la más compleja
La herramienta de preguntas y respuestas devuelve respuestas directas a cualquier pregunta que hagas [03:23]. Hasta aquí suena igual que las demás, pero tiene una complicación extra.
Para que la respuesta sea adecuada necesitas trabajar con un grafo de conocimiento que describa y estructure esa información [04:06]. Además, distintas preguntas pueden pedir formatos diferentes: más texto, menos texto o un tema específico. Por eso se agregan condiciones que ajustan el formato de salida.
¿Por qué todas las herramientas se parecen tanto? Porque las cuatro comparten los mismos parámetros y estructura. Solo cambian el endpoint que consultan y el formato del resultado, lo que acelera muchísimo el desarrollo.
Como en las demás, si algo falla o no hay respuesta, el método muestra el error correspondiente.
Cómo generar documentación con un recurso del MCP
Aquí está el detalle que da ese efecto wow: puedes agregar un recurso que genere archivos markdown para documentar tu propio servidor [04:53].
El recurso se llama README y obtiene la información del servidor MCP. Explica que este servidor entrega las herramientas para integrar búsquedas web con un LLM gracias a SERP API, y lista todas las herramientas disponibles.
¿Qué es un recurso en un MCP server? Es un elemento que tu servidor expone además de las herramientas. En este caso genera documentación automática, de modo que ofreces el servicio y el instructivo de uso al mismo tiempo.
Así no solo le das servicios a tus usuarios, también les entregas la documentación de cómo buscarlos.
Cómo probar el MCP server con el inspector
Con el servidor terminado, se limpia la terminal y se ejecuta el inspector sobre la clase 18 [05:40]. Al conectar y enumerar herramientas, ya no aparecen solo suma, resta y multiplicación, sino un conjunto mucho más capaz.
Estas fueron las pruebas:
- News Search con "GitHub": regresó
success con cinco noticias.
- General Search con "GitHub": devolvió github.com, con el número de resultados prefijado en el código.
- Product Search con "Surface Laptop": mostró varios precios y enlaces.
Después de estas pruebas queda claro que ya tienes varias herramientas de búsqueda listas, sin consultar la API de forma directa y dejando todo preparado para que un cliente se conecte de forma cómoda.
El siguiente paso es mezclar todo: publicar este servidor dentro de una container app y llevarlo a Visual Studio para hacer búsquedas desde SERP API usando VS Code con tu propio MCP server. ¿Qué herramienta de SERP API integrarías primero en tu servidor? Cuéntalo en los comentarios.