ContextStream

Contexto de projeto compartilhado para Cursor, Claude Code, Codex, Grok e outros clientes MCP. Contexto é o gargalo.

Documentação

Servidor MCP ContextStream

Inteligência sem contexto não é confiável. Autonomia sem contexto é caos.
E contexto sem confiança vira vigilância.

Dê a cada agente de codificação memória persistente, busca semântica de código e o contexto certo do projeto em cada interação.

Funciona com Claude Code, Cursor, VS Code + Copilot, Windsurf, Cline, Roo Code, Kilo Code, Codex, OpenCode, Aider, Antigravity e outros clientes MCP.

Instale em 30 segundos · Benchmarks · Documentação · Comece grátis

Sua IA não deveria ter que redescobrir o repositório, reaprender a arquitetura ou repetir o erro da semana passada toda vez que um chat começa. O ContextStream dá aos clientes MCP uma camada de contexto compartilhada que lembra decisões e lições, busca código por significado, mapeia dependências e restaura o fio da meada após a compactação.

O servidor neste repositório é a implementação canônica em Rust, licenciada sob MIT. O transporte recomendado para editores é o MCP hospedado em https://mcp.contextstream.io/mcp; um pequeno auxiliar local mantém checkouts explicitamente vinculados sincronizados.

Benchmarks: memória forte, recuperação forte, metodologia publicada

Publicamos o método completo, intervalos de confiança, ressalvas de comparação e perdas conhecidas—não apenas o número vencedor. Os números de nível de produto abaixo são do relatório publicado em julho de 2026; o resultado LongMemEval-S foi publicado em 14 de junho de 2026.

Benchmark	Resultado ContextStream	O que foi medido
LongMemEval-S	90,0%	450/500 corretos na suíte completa; históricos de múltiplas sessões de ~115 mil tokens; avaliador oficial fixo GPT-4o; `gpt-5.5` leitor com autoconsistência `k=3` (89,6% em disparo único); Wilson IC 95% [87,1%, 92,3%]
Busca de código em repositório fixado	99,38% Recall@10	93,83% Primary@10 e p50 de 95 ms em respostas bem-sucedidas em 177 consultas validadas, média de duas execuções frias e duas quentes; 0/708 solicitações falhas; sem checkout local
Memória de projeto agêntica	96% de sucesso em tarefas	Acima dos 58% sem a camada de memória; um repositório, um modelo de agente, três tentativas por célula, então este resultado é direcional

No benchmark de memória padrão, 90,0% é estatisticamente acima dos 85,4% publicados pela supermemory e estatisticamente empatado com os 90,2% publicados pela Zep. Essas comparações usam o resultado publicado de cada fornecedor; não são apresentadas como um confronto privado na mesma execução.

Leia o relatório completo de benchmarks, metodologia, resultados por categoria e perdas →

O repositório também inclui suítes Criterion para análise de JSON-RPC, despacho de ferramentas, serialização de respostas e primitivas de transporte stdio/HTTP. Execute-as localmente com cargo bench --locked -p mcp-server.

Instale em 30 segundos

Escolha o comando para sua plataforma. Cada instalador baixa a versão nativa atual e inicia o assistente de configuração guiada.

macOS e Linux

curl -fsSL https://contextstream.io/scripts/setup.sh | bash

Versões nativas são publicadas para macOS Apple Silicon e Intel, além de Linux ARM64 e x64.

Windows PowerShell

irm https://contextstream.io/scripts/setup.ps1 | iex

O instalador do Windows usa o binário nativo x64 e o instala no seu perfil de usuário, portanto não precisa de um shell de administrador.

Alternativa npm (Node.js 20+)

npx -y @contextstream/mcp-server@latest setup

O lançador npm sem dependências seleciona o artefato de versão correspondente, verifica sua soma de verificação SHA-256, o armazena em cache pela versão exata do pacote e inicia o binário Rust. Ele suporta macOS ARM64/x64, Linux ARM64/x64 e Windows x64.

O que o assistente faz

O assistente faz seu login, detecta editores suportados, grava a configuração MCP hospedada e regras gerenciadas, instala hooks de ciclo de vida onde suportado, vincula a pasta exata do projeto que você escolher, inicia a indexação e verifica o resultado. Você revisa as escolhas antes que ele faça alterações.

Após a configuração, reinicie o editor e tente:

Use o ContextStream para resumir este repositório, cite os arquivos em que você se baseou e me diga uma decisão ativa ou risco que deva afetar minha próxima mudança.

Quer inspecionar as alterações primeiro? Toda gravação de configuração pode ser pré-visualizada:

contextstream-mcp setup --dry-run

Já configurado e com problemas? Execute:

contextstream-mcp doctor --scope=all --only-configured

Conexão hospedada sem instalação

Se seu cliente MCP suporta Streamable HTTP e OAuth, conecte-se diretamente—não há processo MCP local para manter em execução:

{
  "mcpServers": {
    "contextstream": {
      "type": "http",
      "url": "https://mcp.contextstream.io/mcp"
    }
  }
}

Alguns clientes usam uma chave raiz ou formato de configuração diferente, por isso o assistente de configuração é o caminho mais fácil. O gateway hospedado é o padrão; o auxiliar instalado apenas sincroniza os checkouts locais que você vincula explicitamente.

Clientes que exigem stdio podem usar o lançador npm verificado:

{
  "mcpServers": {
    "contextstream": {
      "command": "npx",
      "args": ["-y", "@contextstream/mcp-server@latest"],
      "env": {
        "CONTEXTSTREAM_API_KEY": "your-api-key"
      }
    }
  }
}

Para automação de produção, fixe uma versão exata do pacote 1.x em vez de latest.

O que seu agente recebe

Capacidade	O que muda na prática
Contexto fundamentado	Cada interação começa com as regras relevantes do workspace, decisões anteriores, lições e estado atual do projeto.
Busca semântica de código	Encontre implementações por intenção, com modos híbrido, por palavra-chave, padrão, exaustivo e ciente de refatoração quando a precisão importa.
Memória durável	Decisões, planos, tarefas, runbooks, preferências e transcrições de sessão permanecem consultáveis entre chats e ferramentas.
Sobrevivência à compactação	Estado importante é verificado antes de conversas longas compactarem e restaurado depois.
Inteligência de dependências	Trace raio de impacto, dependências, importações circulares, complexidade e código não utilizado sem reconstruir manualmente o grafo.
Transferências de agente	Empacote estado verificado e próximos passos em transferências duráveis e ContextCapsules portáteis.
Contexto de equipe	Traga conhecimento compartilhado do workspace e contexto suportado de GitHub, Slack e Notion para a mesma superfície MCP.

A superfície de ferramentas padrão é agrupada em domínios focados—context, search, memory, session, graph, entity, capsule, project, workspace, skill, media, vcs e mais—para que os agentes tenham ampla capacidade sem um enorme prompt de registro de ferramentas.

Editores e agentes suportados

O assistente atualmente detecta e configura:

Claude Code
Cursor
Windsurf
VS Code + GitHub Copilot
Cline
Kilo Code
Roo Code
OpenAI Codex
Aider
Antigravity
OpenCode

Qualquer outra coisa que fale o Model Context Protocol pode se conectar à URL hospedada ou usar o lançador stdio.

O que é open source?

Este repositório contém o servidor MCP Rust canônico, tipos de protocolo, camadas de cliente e sessão, configuração de editor, hooks, código de transporte público, automação de lançamento e a fundação de aceleração sem MongoDB. Ele compila como sete crates de workspace:

mcp-server
mcp-tools
mcp-client
mcp-session
mcp-types
mcp-model-registry
mcp-acceleration-products

O backend hospedado, credenciais, configuração de implantação de produção e implementações de provedores premium não estão incluídos. Traits de compatibilidade de build público permanecem como no-op para que a superfície do protocolo central permaneça estável. Veja docs/architecture.md para o limite.

Privacidade e controles de dados

A configuração mostra uma divulgação antes de alterar a configuração do editor ou indexar um projeto. Você escolhe a pasta e a relação com o workspace; apenas arquivos de origem correspondentes de um projeto validado podem ser indexados. Captura de transcrições, captura de metadados Git locais, regras de ignorar, interruptores de desligamento, comportamento de retenção e caminhos de exclusão são documentados em docs/data-handling.md.

Revise esse documento antes de usar setup --yes em automação. A CLI também fornece --dry-run para fluxos de configuração, reparo, migração e desinstalação.

Compilar e testar a partir do código-fonte

O workspace usa a toolchain Rust fixada em rust-toolchain.toml.

cargo build --locked -p mcp-server --bin contextstream-mcp
cargo test --locked --workspace
cargo bench --locked -p mcp-server

Para compilar a fundação do gateway HTTP hospedado:

cargo build --locked --release -p mcp-server --bin contextstream-mcp \
  --features remote-acceleration

Integridade de lançamento

Todo lançamento publica binários nativos, checksums.txt, version.json e um SBOM SPDX. O lançador npm baixa apenas do caminho imutável para sua versão exata do pacote, verifica manifestos e SHA-256 do binário, usa um cache atômico versionado e suporta reutilização offline verificada com CONTEXTSTREAM_MCP_OFFLINE=1.

Veja docs/release.md para o contrato de lançamento e a versão mais recente do GitHub para artefatos.

Todos os lançamentos npm 1.x preservam estes aliases executáveis:

mcp-server
contextstream-mcp
contextstream-hook (encaminha para o subcomando Rust hook)

Contribuindo e segurança

Issues e pull requests são bem-vindos. Veja CONTRIBUTING.md, SECURITY.md e GOVERNANCE.md. Contribuições devem incluir a assinatura do Developer Certificate of Origin (git commit -s).

O código é licenciado sob MIT. As marcas registradas ContextStream e o limite do serviço hospedado são descritos em NOTICE.

Pare de ensinar ao seu agente de codificação o mesmo projeto duas vezes.
Instale o ContextStream · Comece grátis · Leia a documentação