ContextStream
Contexto compartido de proyecto para Cursor, Claude Code, Codex, Grok y otros clientes MCP. El contexto es el cuello de botella.
Documentación
Servidor MCP de ContextStream
La inteligencia sin contexto no es confiable. La autonomía sin contexto es caos.
Y el contexto sin confianza se convierte en vigilancia.
Dale a cada agente de codificación memoria persistente, búsqueda semántica de código y el contexto de proyecto correcto en cada turno.
Funciona con Claude Code, Cursor, VS Code + Copilot, Windsurf, Cline, Roo Code, Kilo Code, Codex, OpenCode, Aider, Antigravity y otros clientes MCP.
Instalar en 30 segundos · Benchmarks · Documentación · Comenzar gratis
Tu IA no debería tener que redescubrir el repositorio, reaprender la arquitectura o repetir el error de la semana pasada cada vez que comienza un chat. ContextStream les da a los clientes MCP una capa de contexto compartida que recuerda decisiones y lecciones, busca código por significado, mapea dependencias y restaura el hilo después de la compactación.
El servidor en este repositorio es la implementación canónica en Rust con licencia
MIT. El transporte recomendado para editores es el MCP alojado en
https://mcp.contextstream.io/mcp; un pequeño asistente local mantiene sincronizados los
checkouts vinculados explícitamente.
Benchmarks: memoria sólida, recuperación sólida, metodología publicada
Publicamos el método completo, los intervalos de confianza, las advertencias de comparación y las pérdidas conocidas, no solo el número ganador. Las cifras a nivel de producto a continuación provienen del informe publicado de julio de 2026; el resultado de LongMemEval-S se publicó el 14 de junio de 2026.
| Benchmark | Resultado de ContextStream | Qué se midió |
|---|---|---|
| LongMemEval-S | 90.0% | 450/500 correctos en la suite completa; historias de múltiples sesiones de ~115k tokens; juez oficial fijado GPT-4o; gpt-5.5 lector con auto-consistencia k=3 (89.6% de un solo disparo); IC de Wilson al 95% [87.1%, 92.3%] |
| Búsqueda de código en repositorio fijado | 99.38% Recall@10 | 93.83% Primary@10 y p50 de 95 ms en respuestas exitosas sobre 177 consultas validadas, promediado en dos ejecuciones en frío y dos en caliente; 0/708 solicitudes fallidas; sin checkout local |
| Memoria de proyecto agéntica | 96% de éxito en tareas | Frente al 58% sin la capa de memoria; un repositorio, un modelo de agente, tres pruebas por celda, por lo que este resultado es direccional |
En el benchmark de memoria estándar, el 90.0% está estadísticamente por encima del 85.4% publicado por supermemory y estadísticamente empatado con el 90.2% publicado por Zep. Esas comparaciones usan el resultado publicado de cada proveedor; no se presentan como una comparación privada en la misma ejecución.
Leer el informe completo de benchmarks, metodología, resultados por categoría y pérdidas →
El repositorio también incluye suites de Criterion para análisis de JSON-RPC,
despacho de herramientas, serialización de respuestas y primitivas de transporte
stdio/HTTP. Ejecútalas localmente con cargo bench --locked -p mcp-server.
Instalar en 30 segundos
Elige el comando para tu plataforma. Cada instalador descarga la versión nativa actual e inicia el asistente de configuración guiado.
macOS y Linux
curl -fsSL https://contextstream.io/scripts/setup.sh | bash
Las versiones nativas se publican para macOS Apple Silicon e Intel, además de Linux ARM64 y x64.
Windows PowerShell
irm https://contextstream.io/scripts/setup.ps1 | iex
El instalador de Windows usa el binario nativo x64 y lo instala en tu perfil de usuario, por lo que no necesita un shell de administrador.
Alternativa npm (Node.js 20+)
npx -y @contextstream/mcp-server@latest setup
El lanzador npm sin dependencias selecciona el artefacto de versión correspondiente, verifica su checksum SHA-256, lo almacena en caché por versión exacta del paquete e inicia el binario de Rust. Admite macOS ARM64/x64, Linux ARM64/x64 y Windows x64.
Qué hace el asistente
El asistente te inicia sesión, detecta los editores compatibles, escribe su configuración MCP alojada y las reglas gestionadas, instala hooks de ciclo de vida donde se admiten, vincula la carpeta exacta del proyecto que elijas, comienza la indexación y verifica el resultado. Revisas las opciones antes de que realice cambios.
Después de la configuración, reinicia el editor y prueba:
Usa ContextStream para resumir este repositorio, cita los archivos en los que te basaste y dime una decisión activa o un riesgo que debería afectar mi próximo cambio.
¿Quieres inspeccionar los cambios primero? Cada escritura de configuración se puede previsualizar:
contextstream-mcp setup --dry-run
¿Ya configurado y solucionando problemas? Ejecuta:
contextstream-mcp doctor --scope=all --only-configured
Conexión alojada sin instalación
Si tu cliente MCP admite Streamable HTTP y OAuth, conéctate directamente: no hay proceso MCP local que mantener en ejecución:
{
"mcpServers": {
"contextstream": {
"type": "http",
"url": "https://mcp.contextstream.io/mcp"
}
}
}
Algunos clientes usan una clave raíz o un formato de configuración diferente, por eso el asistente de configuración es la vía más fácil. La puerta de enlace alojada es la predeterminada; el asistente instalado solo sincroniza los checkouts locales que vincules explícitamente.
Los clientes que requieren stdio pueden usar el lanzador npm verificado:
{
"mcpServers": {
"contextstream": {
"command": "npx",
"args": ["-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_KEY": "your-api-key"
}
}
}
}
Para automatización en producción, fija una versión exacta del paquete 1.x en
lugar de latest.
Qué obtiene tu agente
| Capacidad | Qué cambia en la práctica |
|---|---|
| Contexto fundamentado | Cada turno comienza con las reglas relevantes del espacio de trabajo, decisiones previas, lecciones y el estado actual del proyecto. |
| Búsqueda semántica de código | Encuentra implementaciones por intención, con modos híbrido, por palabra clave, por patrón, exhaustivo y consciente de refactorización cuando la precisión importa. |
| Memoria duradera | Decisiones, planes, tareas, runbooks, preferencias y transcripciones de sesión permanecen consultables entre chats y herramientas. |
| Supervivencia a la compactación | El estado importante se guarda antes de que las conversaciones largas se compacten y se restaura después. |
| Inteligencia de dependencias | Traza el radio de impacto, dependencias, importaciones circulares, complejidad y código no utilizado sin reconstruir manualmente el grafo. |
| Transferencias entre agentes | Empaqueta estado verificado y próximos pasos en transferencias duraderas y ContextCapsules portátiles. |
| Contexto de equipo | Lleva conocimiento compartido del espacio de trabajo y contexto compatible de GitHub, Slack y Notion a la misma superficie MCP. |
La superficie de herramientas predeterminada se agrupa en dominios enfocados:
context, search,
memory, session, graph, entity, capsule, project, workspace,
skill, media, vcs y más, para que los agentes
obtengan una amplia capacidad sin un prompt de registro de herramientas enorme.
Editores y agentes compatibles
El asistente actualmente detecta y configura:
- Claude Code
- Cursor
- Windsurf
- VS Code + GitHub Copilot
- Cline
- Kilo Code
- Roo Code
- OpenAI Codex
- Aider
- Antigravity
- OpenCode
Cualquier otra cosa que hable el Model Context Protocol puede conectarse a la URL alojada o usar el lanzador stdio.
¿Qué es de código abierto?
Este repositorio contiene el servidor MCP canónico en Rust, tipos de protocolo, capas de cliente y sesión, configuración de editores, hooks, código de transporte público, automatización de versiones y la base de aceleración sin MongoDB. Se compila como siete crates de espacio de trabajo:
mcp-servermcp-toolsmcp-clientmcp-sessionmcp-typesmcp-model-registrymcp-acceleration-products
El backend alojado, las credenciales, la configuración de despliegue de producción
y las implementaciones de proveedores premium no están incluidos. Los rasgos de
compatibilidad de compilación pública permanecen como no-op para que la superficie
del protocolo central se mantenga estable. Consulta
docs/architecture.md para el límite.
Privacidad y controles de datos
La configuración muestra una divulgación antes de cambiar la configuración del
editor o indexar un proyecto. Tú eliges la carpeta y la relación del espacio de
trabajo; solo los archivos fuente coincidentes de un proyecto validado pueden
indexarse. La captura de transcripciones, la captura de metadatos locales de Git,
las reglas de ignorar, los interruptores de apagado, el comportamiento de retención
y las rutas de eliminación están documentados en docs/data-handling.md.
Revisa ese documento antes de usar setup --yes en automatización. La CLI
también proporciona --dry-run para flujos de trabajo de configuración,
reparación, migración y desinstalación.
Compilar y probar desde el código fuente
El espacio de trabajo usa la cadena de herramientas de Rust fijada en rust-toolchain.toml.
cargo build --locked -p mcp-server --bin contextstream-mcp
cargo test --locked --workspace
cargo bench --locked -p mcp-server
Para compilar la base de la puerta de enlace HTTP alojada:
cargo build --locked --release -p mcp-server --bin contextstream-mcp \
--features remote-acceleration
Integridad de versiones
Cada versión publica binarios nativos, checksums.txt, version.json y
un SBOM SPDX. El lanzador npm descarga solo desde la ruta inmutable para su
versión exacta del paquete, verifica manifiestos y SHA-256 del binario, usa una
caché atómica versionada y admite reutilización sin conexión verificada con
CONTEXTSTREAM_MCP_OFFLINE=1.
Consulta docs/release.md para el contrato de versiones y
la última versión de GitHub
para los artefactos.
Todas las versiones npm 1.x conservan estos alias ejecutables:
mcp-servercontextstream-mcpcontextstream-hook(reenvía al subcomandohookde Rust)
Contribuciones y seguridad
Las issues y las pull requests son bienvenidas. Consulta CONTRIBUTING.md,
SECURITY.md y GOVERNANCE.md. Las
contribuciones deben incluir la firma del Developer Certificate of Origin (git commit -s).
El código tiene licencia MIT. Las marcas comerciales de ContextStream y el límite del servicio alojado se describen en NOTICE.
Deja de enseñarle a tu agente de codificación el mismo proyecto dos veces.
Instalar ContextStream ·
Comenzar gratis ·
Leer la documentación