search-mcp
Toolkit open source para Cloudflare AI Search que incluye servidor MCP, Workers de consulta y sincronización Git a R2. Soporta indexación de repositorios con remapeo de extensiones y licenciamiento AGPL v3.
Ficha actualizada 25 sept 2026, 21:36 · upstream 25 sept 2026, 21:21 · release v0.5.1
Qué es search-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este toolkit proporciona una solución completa para integrar búsqueda semántica en infraestructura Cloudflare. Incluye un servidor MCP (src/mcp.ts) para agentes que requieren acceso programático, y un Worker de consulta (src/index.ts) para widgets web con protección CORS y Turnstile.
La sincronización de corpus utiliza scripts Node.js para subir contenido desde repositorios Git a buckets R2, remapeando extensiones como .ts o Dockerfile a .txt para asegurar su indexación por el motor AI Search. El despliegue se realiza mediante Wrangler y npm, sin necesidad de contenedores Docker.
Se gestiona la autenticación mediante tokens Bearer para endpoints MCP y listas de allowlist para widgets públicos. La arquitectura permite separar tráfico de agentes del tráfico web, asignando diferentes instancias de AI Search a cada Worker según las necesidades de seguridad y privacidad del corpus.
- Integración de RAG en agentes autónomos vía protocolo MCP
- Widget de búsqueda pública para documentación técnica con Turnstile
- Sincronización automática de repositorios Git a almacenamiento R2
- Indexación de archivos de código y Dockerfiles para análisis semántico
- Gestión de corpus privados e internos con autenticación Bearer
- Licencia AGPL v3 garantizando código abierto
- Servidor MCP Streamable-HTTP nativo para agentes
- Remapeo automático de extensiones no estándar a .txt
- Manejo robusto de cooldowns y reindexación en AI Search
- Soporte CLI search-mcp-sync para gestión de corpus
- Separación lógica entre Workers públicos y MCP
- No incluye Dockerfile ni Compose, requiere despliegue manual Wrangler
- Límite de tamaño por objeto en R2 (4MB por defecto)
- Dependencia obligatoria de Cloudflare AI Search y R2
- Reglas de paths includePaths fallan cerrado si no se configuran bien
- Requiere configuración manual de secretos en wrangler.toml
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar npm, copiar wrangler.toml.example, editar targets.json. Ejecutar npm run sync:dry-run para validar. Subir corpus con npm run sync. Desplegar Workers: npm run deploy (público) y npm run deploy:mcp (interno). Asegurar bucket R2 vinculado como CORPUS.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.