ContextStream

Contexto compartido de proyecto para Cursor, Claude Code, Codex, Grok y otros clientes MCP. El contexto es el cuello de botella.

Documentación

ContextStream

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.

npm version latest release CI status MIT license

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.

BenchmarkResultado de ContextStreamQué se midió
LongMemEval-S90.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 fijado99.38% Recall@1093.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éntica96% de éxito en tareasFrente 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

CapacidadQué cambia en la práctica
Contexto fundamentadoCada 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ódigoEncuentra 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 duraderaDecisiones, planes, tareas, runbooks, preferencias y transcripciones de sesión permanecen consultables entre chats y herramientas.
Supervivencia a la compactaciónEl estado importante se guarda antes de que las conversaciones largas se compacten y se restaura después.
Inteligencia de dependenciasTraza el radio de impacto, dependencias, importaciones circulares, complejidad y código no utilizado sin reconstruir manualmente el grafo.
Transferencias entre agentesEmpaqueta estado verificado y próximos pasos en transferencias duraderas y ContextCapsules portátiles.
Contexto de equipoLleva 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-server
  • mcp-tools
  • mcp-client
  • mcp-session
  • mcp-types
  • mcp-model-registry
  • mcp-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-server
  • contextstream-mcp
  • contextstream-hook (reenvía al subcomando hook de 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