Mi Primer Servidor MCP: Búsqueda Semántica de Código

Aprende a usar MCP y Seroost para que agentes IA busquen código semánticamente, obteniendo fragmentos y ubicaciones exactas sin subir ficheros ni perder contexto.

15 sept 2025 • 4 min read • Q2BSTUDIO Team

Inteligencia-Artificial-

En este artículo explico cómo construí un servidor que implementa el protocolo Model Context Protocol MCP para permitir que agentes IA busquen bases de código semánticamente usando Seroost, y por qué esto tiene sentido para equipos de desarrollo y empresas que necesitan soluciones de aplicaciones a medida y software a medida.

Por qué lo hice Al principio no era partidario del llamado coding agentivo. Dejar que agentes IA actúen libremente sobre un repositorio me parecía caótico. Todo cambió cuando vi un vídeo sobre cómo crear servidores MCP. Entendí que si los agentes pueden usar herramientas externas de forma controlada, realmente pueden ser útiles. Yo ya había desarrollado Seroost, un motor de búsqueda semántica de código escrito en Rust que indexa y consulta documentos usando TF IDF. Es rápido, detecta fragmentos y funciona bien en directorios grandes. Lo que faltaba era conectarlo con agentes IA mediante un puerto estándar, y ese es el papel de MCP.

El problema con los asistentes IA actuales Cuando trabajas con asistentes como Claude o GitHub Copilot en proyectos grandes suele pasar esto Pides información sobre lógica de autenticación Te piden que subas archivos Pegas docenas de ficheros y aun así les falta contexto Gran parte de los agentes se basa en búsquedas por palabras clave o en búsquedas semánticas superficiales y no comprenden la estructura del proyecto.

MCP más Seroost MCP actúa como un adaptador universal para herramientas IA. Pensemos en él como el puerto USB para agentes IA un protocolo estándar que permite a cualquier agente conectarse a herramientas externas. Al convertir Seroost en un servidor MCP, di a los agentes la capacidad de buscar código semánticamente, devolver resultados ordenados con fragmentos y números de línea, y operar sin subidas manuales constantes.

Cómo monté el servidor MCP Manteniendo la configuración ligera me centré en tres acciones principales Definir ruta de índice indicar a Seroost qué directorio indexar Construir índice ejecutar el proceso de indexado Buscar consultar el índice con coincidencia semántica y fuzzy El servidor envuelve la interfaz de línea de comandos de Seroost usando child process spawn de Node, interpreta los resultados JSON y los expone por MCP. De forma resumida el servidor recibe una consulta en lenguaje natural ejecuta la búsqueda en Seroost y devuelve un paquete con resultados rankeados incluyendo fragmentos y ubicaciones exactas en los ficheros.

Qué cambia para los agentes Antes IA Pide tus archivos Yo subo 15 ficheros IA responde tal vez esto es pero puede que falte contexto Después IA Déjame buscar en el proyecto funciones de autenticación Resultado ejemplo ruta src auth authenticate js función authenticateUser credenciales ruta src middleware auth js verificación de token El agente ya no adivina a ciegas, puede escanear el proyecto entero y saltar a las líneas relevantes.

Por qué importa Velocidad no hay que subir ficheros manualmente, descubrimiento instantáneo. Escalabilidad funciona con miles de archivos. Semántica detecta patrones como middleware de manejo de errores no solo palabras clave. Componibilidad funciona con cualquier agente que soporte MCP, no con una sola plataforma.

Ejemplo de despliegue Instalar Seroost cargo build --release Clonar el servidor MCP y ejecutar npm install Agregar el servidor MCP a la configuración del cliente IA señalando el ejecutable node y la ruta del build Ejecutar seroost set index luego seroost index y a continuación realizar búsquedas semánticas

Qué sigue Esto es solo el comienzo. MCP permite exponer cualquier herramienta a agentes IA Consultar bases de datos Analizar logs Desplegar recursos en la nube Ejecutar pruebas En Q2BSTUDIO seguimos ampliando capacidades más allá de la búsqueda de código integrando soluciones de inteligencia artificial, servicios cloud aws y azure y automatización para empresas. Si necesitas desarrollo de aplicaciones a medida o quieres explorar cómo incorporar agentes IA en tus procesos consulta nuestros servicios. También ofrecemos proyectos y consultoría en inteligencia artificial, ciberseguridad, servicios inteligencia de negocio y power bi para potenciar la toma de decisiones.

Conclusiones Construir este servidor me dejó varias enseñanzas MCP es joven pero prometedor Herramientas sencillas se vuelven potentes cuando se estandarizan La búsqueda semántica hace a los agentes IA mucho más útiles Debería haberme subido antes al tren del coding agentivo

Sobre Q2BSTUDIO Q2BSTUDIO es una empresa de desarrollo de software especializada en software a medida y aplicaciones a medida. Ofrecemos servicios de inteligencia artificial ia para empresas, ciberseguridad y pentesting, servicios cloud aws y azure, servicios inteligencia de negocio y soluciones con power bi. Si te interesa transformar tu producto o automatizar procesos con agentes IA y herramientas a medida, en Q2BSTUDIO podemos ayudarte a diseñar e integrar la solución adecuada.

Pregunta final Qué herramienta conectarías a tu agente IA si pudieras potenciarla con búsquedas semánticas y acceso controlado al contexto del proyecto

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat