Servidor MCP de investigación de código

Un servidor de Protocolo de Contexto de Modelo que proporciona herramientas para buscar y acceder a recursos de programación en múltiples plataformas. Este servidor se integra con plataformas de desarrollo populares para ayudar a los LLM a encontrar ejemplos de código, documentación y paquetes relevantes.

Características

Plataformas integradas

• Stack Overflow - Preguntas y respuestas sobre programación
• MDN Web Docs: documentación de desarrollo web
• GitHub - Búsqueda de código y repositorio
• npm - Registro de paquetes de JavaScript
• PyPI - Índice de paquetes de Python

Herramientas

search_stackoverflow

Busque en Stack Overflow preguntas y respuestas de programación.

• Parámetros:
  • query (obligatoria): cadena de consulta de búsqueda
  • limit (opcional): Máximo de resultados (1-10, predeterminado: 5)
• Devuelve: Lista formateada de preguntas con puntuaciones, recuentos de respuestas y extractos
• Los resultados se almacenan en caché durante 1 hora

search_mdn

Busque documentación sobre desarrollo web en MDN Web Docs.

• Parámetros:
  • query (obligatoria): cadena de consulta de búsqueda
• Devoluciones: Las 5 principales coincidencias de documentación de MDN con resúmenes y enlaces
• Los resultados se almacenan en caché durante 1 hora

search_github

Busque en GitHub repositorios y ejemplos de código.

• Parámetros:
  • query (obligatoria): cadena de consulta de búsqueda
  • language (opcional): Filtrar por lenguaje de programación
  • limit (opcional): Máximo de resultados por categoría (1-10, predeterminado: 5)
• Devoluciones: Dos secciones:
  1. Los mejores repositorios ordenados por estrellas
  2. Archivos de código relevantes con contexto de repositorio
• Los resultados se almacenan en caché durante 1 hora

search_npm

Busque paquetes de JavaScript en el registro npm.

• Parámetros:
  • query (obligatoria): cadena de consulta de búsqueda
  • limit (opcional): Máximo de resultados (1-10, predeterminado: 5)
• Devoluciones: Información del paquete, incluida la versión, la descripción y las estadísticas de descarga.
• Los resultados se almacenan en caché durante 1 hora

search_pypi

Busque paquetes de Python en PyPI.

• Parámetros:
  • query (obligatoria): cadena de consulta de búsqueda
• Devoluciones: Información detallada del paquete, incluyendo versión, autor y enlaces.
• Los resultados se almacenan en caché durante 1 hora

search_all

Busque en todas las plataformas simultáneamente para obtener resultados completos.

• Parámetros:
  • query (obligatoria): cadena de consulta de búsqueda
  • limit (opcional): Máximo de resultados por plataforma (1-5, predeterminado: 3)
• Devoluciones: Resultados combinados de todas las plataformas:
  1. Preguntas y respuestas de Stack Overflow
  2. Documentación de MDN
  3. Repositorios y código de GitHub
  4. paquetes npm
  5. Paquetes de PyPI
• Los resultados se almacenan en caché durante 1 hora
• Nota: ejecuta todas las búsquedas en paralelo para una respuesta más rápida

Requisitos

• Node.js >= 20.11.0
• npm >= 10.0.0
• Opcional: Token de acceso personal de GitHub para límites de velocidad de API más altos

Instalación

Instalación mediante herrería

Para instalar Code Research Server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

1. Clonar el repositorio e instalar las dependencias:

2. Construir el servidor:

3. Configurar los ajustes de MCP:

Agregue la configuración del servidor a su archivo de configuración de MCP:

• VSCode: ~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• Escritorio de Claude:
  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Ventanas: %APPDATA%/Claude/claude_desktop_config.json

Nota: Reemplace /absolute/path/to con la ruta real donde clonó el repositorio.

Desarrollo

Ejecutando en modo de desarrollo

Para desarrollo con reconstrucción automática ante cambios:

Manejo de errores

El servidor implementa un manejo robusto de errores:

• Mensajes de error específicos de la API para cada plataforma
• Manejo del límite de velocidad para la API de GitHub
• Respaldos elegantes en caso de indisponibilidad del servicio
• Respuestas almacenadas en caché para reducir la carga de la API

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Utilice el Inspector MCP para una monitorización detallada de solicitudes y respuestas:

El Inspector proporciona:

• Monitoreo de solicitudes y respuestas en tiempo real
• Seguimiento de la ejecución de herramientas
• Rastreos de pila de errores
• Métricas de rendimiento

Visite la URL proporcionada en su navegador para acceder a la interfaz de depuración.

Almacenamiento en caché

Los resultados se almacenan en caché mediante node-cache :

• TTL predeterminado: 1 hora
• Claves de caché independientes por combinación de consulta/límite
• Estrategias de almacenamiento en caché específicas de la plataforma
• Almacenamiento con uso eficiente de la memoria

Contribuyendo

1. Bifurcar el repositorio
2. Crear una rama de características
3. Confirme sus cambios
4. Empujar hacia la rama
5. Crear una solicitud de extracción

Licencia

AGPLv3