ContextStream MCP Server

Your AI should not have to rediscover the repository, re-learn the architecture, or repeat last week's mistake every time a chat starts. ContextStream gives MCP clients a shared context layer that remembers decisions and lessons, searches code by meaning, maps dependencies, and restores the thread after compaction.

The server in this repository is the canonical, MIT-licensed Rust implementation. The recommended editor transport is the hosted MCP at https://mcp.contextstream.io/mcp; a small local helper keeps explicitly linked checkouts in sync.

Benchmarks: strong memory, strong retrieval, published methodology

We publish the full method, confidence intervals, comparison caveats, and known losses—not just the winning number. The product-level figures below are from the published July 2026 report; the LongMemEval-S result was published June 14, 2026.

On the standard memory benchmark, 90.0% is statistically above supermemory's published 85.4% and statistically tied with Zep's published 90.2%. Those comparisons use each vendor's published result; they are not presented as a private same-run head-to-head.

Read the full benchmark report, methodology, per-category results, and losses →

The repository also includes Criterion suites for JSON-RPC parsing, tool dispatch, response serialization, and stdio/HTTP transport primitives. Run them locally with cargo bench --locked -p mcp-server.

Install in 30 seconds

Pick the command for your platform. Each installer downloads the current native release and launches the guided setup wizard.

macOS and Linux

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

Native releases are published for macOS Apple Silicon and Intel, plus Linux ARM64 and x64.

Windows PowerShell

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

The Windows installer uses the native x64 binary and installs it in your user profile, so it does not need an administrator shell.

npm alternative (Node.js 20+)

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

The dependency-free npm launcher selects the matching release artifact, verifies its SHA-256 checksum, caches it by exact package version, and starts the Rust binary. It supports macOS ARM64/x64, Linux ARM64/x64, and Windows x64.

What the wizard does

The wizard signs you in, detects supported editors, writes their hosted MCP configuration and managed rules, installs lifecycle hooks where supported, links the exact project folder you choose, starts indexing, and checks the result. You review the choices before it makes changes.

After setup, restart the editor and try:

Use ContextStream to summarize this repository, cite the files you relied on, and tell me one active decision or risk that should affect my next change.

Want to inspect the changes first? Every setup write can be previewed:

contextstream-mcp setup --dry-run

Already configured and troubleshooting? Run:

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

No-install hosted connection

If your MCP client supports Streamable HTTP and OAuth, connect directly—there is no local MCP process to keep running:

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

Some clients use a different root key or config format, which is why the setup wizard is the easiest path. The hosted gateway is the default; the installed helper only syncs the local checkouts you explicitly link.

Clients that require stdio can use the verified npm launcher:

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

For production automation, pin an exact 1.x package version instead of latest.

What your agent gets

The default tool surface is grouped into focused domains—context, search, memory, session, graph, entity, capsule, project, workspace, skill, media, vcs, and more—so agents get broad capability without an enormous tool-registration prompt.

Supported editors and agents

The wizard currently detects and configures:

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

Anything else that speaks the Model Context Protocol can connect to the hosted URL or use the stdio launcher.

What is open source?

This repository contains the canonical Rust MCP server, protocol types, client and session layers, editor setup, hooks, public transport code, release automation, and the MongoDB-free acceleration foundation. It builds as seven workspace crates:

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

The hosted backend, credentials, production deployment configuration, and premium provider implementations are not included. Public-build compatibility traits remain no-op so the core protocol surface stays stable. See docs/architecture.md for the boundary.

Privacy and data controls

Setup shows a disclosure before changing editor configuration or indexing a project. You choose the folder and workspace relationship; only matching source files from a validated project can be indexed. Transcript capture, local Git metadata capture, ignore rules, kill switches, retention behavior, and deletion paths are documented in docs/data-handling.md.

Review that document before using setup --yes in automation. The CLI also provides --dry-run for setup, repair, migration, and uninstall workflows.

Build and test from source

The workspace uses the Rust toolchain pinned in rust-toolchain.toml.

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

To build the hosted HTTP gateway foundation:

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

Release integrity

Every release publishes native binaries, checksums.txt, version.json, and an SPDX SBOM. The npm launcher downloads only from the immutable path for its exact package version, verifies manifests and binary SHA-256, uses an atomic versioned cache, and supports verified offline reuse with CONTEXTSTREAM_MCP_OFFLINE=1.

See docs/release.md for the release contract and the latest GitHub release for artifacts.

All 1.x npm releases preserve these executable aliases:

• mcp-server
• contextstream-mcp
• contextstream-hook (forwards to the Rust hook subcommand)

Contributing and security

Issues and pull requests are welcome. See CONTRIBUTING.md, SECURITY.md, and GOVERNANCE.md. Contributions must include the Developer Certificate of Origin sign-off (git commit -s).

The code is MIT licensed. ContextStream trademarks and the hosted-service boundary are described in NOTICE.