@contextstream/mcp-server 1.0.6 → 1.0.8

package/README.md

@@ -1,286 +1,136 @@
 <!-- mcp-name: io.github.contextstream/mcp-server -->
 
 <p align="center">
-  <img src="assets/contextstream-logo.png" alt="ContextStream" width="112" />
+  <img src="assets/contextstream-logo.png" alt="ContextStream" width="64" />
 </p>
 
 <h1 align="center">ContextStream MCP Server</h1>
 
-<p align="center">
-  <em>Intelligence without context is unreliable. Autonomy without context is chaos.<br/>
-  And context without trust becomes surveillance.</em>
-</p>
+<p align="center"><strong>Persistent memory. Millisecond code search.</strong></p>
 
-<p align="center">
-  <strong>Give every coding agent persistent memory, semantic code search, and the right project context on every turn.</strong>
-</p>
-
-<p align="center">
-  Works with Claude Code, Cursor, VS Code + Copilot, Windsurf, Cline, Roo Code, Kilo Code, Codex, OpenCode, Aider, Antigravity, and other MCP clients.
-</p>
+## Your agent knows code. Give it the decisions behind yours.
 
-<p align="center">
-  <a href="https://www.npmjs.com/package/@contextstream/mcp-server"><img src="https://img.shields.io/npm/v/@contextstream/mcp-server.svg" alt="npm version" /></a>
-  <a href="https://github.com/contextstream/mcp-server/releases/latest"><img src="https://img.shields.io/github/v/release/contextstream/mcp-server" alt="latest release" /></a>
-  <a href="https://github.com/contextstream/mcp-server/actions/workflows/ci.yml"><img src="https://github.com/contextstream/mcp-server/actions/workflows/ci.yml/badge.svg" alt="CI status" /></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT license" /></a>
-</p>
+Connect your code, docs, and conversations so your agents can find the right
+files, recall saved decisions, and build on past work across sessions and tools.
 
-<p align="center">
-  <a href="#install-in-30-seconds"><strong>Install in 30 seconds</strong></a> ·
-  <a href="https://contextstream.io/benchmarks">Benchmarks</a> ·
-  <a href="https://contextstream.io/docs/mcp">Documentation</a> ·
-  <a href="https://contextstream.io/signup">Start free</a>
-</p>
+<a id="install-in-30-seconds"></a>
 
----
+## Start free with MCP
 
-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.
+**10,000 monthly credits. No credit card required.**
 
-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.
+Works with Claude Code, Cursor, Codex, and other supported MCP clients.
+Create your account or sign in during MCP onboarding. No separate website signup needed.
 
-## Benchmarks: strong memory, strong retrieval, published methodology
+**macOS and Linux**
 
-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.
+```sh
+bash -o pipefail -c 'curl -fsSL https://contextstream.io/scripts/mcp.sh | bash'
+```
 
-| Benchmark | ContextStream result | What was measured |
-|---|---:|---|
-| **LongMemEval-S** | **90.0%** | 450/500 correct on the full suite; ~115k-token multi-session histories; official pinned GPT-4o judge; `gpt-5.5` reader with self-consistency `k=3` (89.6% single-shot); Wilson 95% CI [87.1%, 92.3%] |
-| **Pinned-repo code search** | **99.38% Recall@10** | 93.83% Primary@10 and 95 ms successful-response p50 over 177 judged-valid queries, averaged across two cold and two warm runs; 0/708 failed requests; no local checkout |
-| **Agentic project memory** | **96% task success** | Up from 58% without the memory layer; one repository, one agent model, three trials per cell, so this result is directional |
+**Windows PowerShell**
 
-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.
+```powershell
+irm https://contextstream.io/scripts/mcp.ps1 | iex
+```
 
-**[Read the full benchmark report, methodology, per-category results, and losses →](https://contextstream.io/benchmarks)**
+Paste the command into your terminal and follow onboarding to connect your
+project and supported editor. Restart your editor after setup.
 
-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`.
+[What gets installed and indexed?](docs/data-handling.md) ·
+[Setup guide](https://contextstream.io/docs/editors/setup) ·
+[Prefer to start on the web?](https://contextstream.io/signup)
 
-## Install in 30 seconds
+## Make the next session useful
 
-Pick the command for your platform. Each installer downloads the current native
-release and launches the guided setup wizard.
+Ask your connected agent:
 
-### macOS and Linux
+> Use ContextStream to find the files relevant to my next change. Cite the
+> sources and retrieve any saved project decisions that should guide the work.
 
-```bash
-curl -fsSL https://contextstream.io/scripts/setup.sh | bash
-```
+Then ask it to save a real decision and its reason. Start a new session and
+retrieve that decision without explaining it again. Indexing supplies code
+context; it cannot recover every undocumented decision.
 
-Native releases are published for macOS Apple Silicon and Intel, plus Linux
-ARM64 and x64.
+## Proof and data controls
 
-### Windows PowerShell
+**95 ms median code search in our published benchmark.** This is the measured
+successful-response median for the disclosed configuration, not a latency guarantee.
+[See results, methodology, and limitations](https://contextstream.io/benchmarks).
 
-```powershell
-irm https://contextstream.io/scripts/setup.ps1 | iex
-```
+**Scoped access. Traceable sources. Configurable capture.**
+Indexing sends eligible source contents to ContextStream for hosted search.
+Transcript saving and local Git metadata capture are on by default and can be
+turned off. Review [data handling and controls](docs/data-handling.md) before
+connecting sensitive projects.
 
-The Windows installer uses the native x64 binary and installs it in your user
-profile, so it does not need an administrator shell.
+<details>
+<summary><strong>Other installation options and troubleshooting</strong></summary>
 
-### npm alternative (Node.js 20+)
+### npm (Node.js 20+)
 
 ```bash
 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.
+The npm launcher downloads the native Rust binary for your platform and verifies
+its SHA-256 checksum. Pin an exact package version for production automation.
 
-### What the wizard does
+### Hosted MCP without a local process
 
-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.
+For clients supporting Streamable HTTP and OAuth, the hosted endpoint is:
 
-After setup, restart the editor and try:
+```text
+https://mcp.contextstream.io/mcp
+```
 
-> 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.
+Use the [MCP documentation](https://contextstream.io/docs/mcp) for your client's
+configuration and stdio alternatives. A hosted connection alone does not sync
+your local checkout.
 
-Want to inspect the changes first? Every setup write can be previewed:
+### Preview or diagnose setup
 
 ```bash
 contextstream-mcp setup --dry-run
-```
-
-Already configured and troubleshooting? Run:
-
-```bash
 contextstream-mcp doctor --scope=all --only-configured
 ```
 
-## No-install hosted connection
+### Scripted and CI setup
 
-If your MCP client supports Streamable HTTP and OAuth, connect directly—there
-is no local MCP process to keep running:
+`pipefail` makes the install command fail when the download fails, instead of
+reporting success after installing nothing. `setup --yes` reads the key from
+`CONTEXTSTREAM_API_KEY` or saved credentials, and needs `--workspace-id` when
+the account has more than one workspace:
 
-```json
-{
-  "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:
-
-```json
-{
-  "mcpServers": {
-    "contextstream": {
-      "command": "npx",
-      "args": ["-y", "@contextstream/mcp-server@latest"],
-      "env": {
-        "CONTEXTSTREAM_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
+```bash
+export CONTEXTSTREAM_API_KEY=...   # or: printf %s "$KEY" | contextstream-mcp configure --api-key-stdin
+contextstream-mcp setup --yes --editors=claude --workspace-id=<UUID> --project-path=.
 ```
 
-For production automation, pin an exact 1.x package version instead of
-`latest`.
-
-## What your agent gets
+</details>
 
-| Capability | What changes in practice |
-|---|---|
-| **Grounded context** | Each turn starts with the relevant workspace rules, prior decisions, lessons, and current project state. |
-| **Semantic code search** | Find implementations by intent, with hybrid, keyword, pattern, exhaustive, and refactor-aware modes when precision matters. |
-| **Durable memory** | Decisions, plans, tasks, runbooks, preferences, and session transcripts remain queryable across chats and tools. |
-| **Compaction survival** | Important state is checkpointed before long conversations compact and restored afterward. |
-| **Dependency intelligence** | Trace blast radius, dependencies, circular imports, complexity, and unused code without manually rebuilding the graph. |
-| **Agent handoffs** | Package verified state and next steps into durable handoffs and portable ContextCapsules. |
-| **Team context** | Bring shared workspace knowledge and supported GitHub, Slack, and Notion context into the same MCP surface. |
+## Open source and contributing
 
-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`](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`](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`.
+This repository contains the MIT-licensed Rust MCP server, client, editor setup,
+and release tooling. The hosted backend is separate and is not included here.
+See the [architecture](docs/architecture.md), [release integrity](docs/release.md),
+and [latest release](https://github.com/contextstream/mcp-server/releases/latest).
 
 ```bash
 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:
-
-```bash
-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`](docs/release.md) for the release contract and
-[the latest GitHub release](https://github.com/contextstream/mcp-server/releases/latest)
-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](CONTRIBUTING.md),
-[SECURITY.md](SECURITY.md), and [GOVERNANCE.md](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](NOTICE).
+Use the pinned Rust toolchain. For contribution checks and commit sign-off, read
+[CONTRIBUTING.md](CONTRIBUTING.md). Report vulnerabilities using
+[SECURITY.md](SECURITY.md). See [LICENSE](LICENSE), [NOTICE](NOTICE), and
+[GOVERNANCE.md](GOVERNANCE.md) for licensing, trademarks, and project governance.
 
 ---
 
-<p align="center">
-  <strong>Stop teaching your coding agent the same project twice.</strong><br />
-  <a href="#install-in-30-seconds">Install ContextStream</a> ·
-  <a href="https://contextstream.io/signup">Start free</a> ·
-  <a href="https://contextstream.io/docs/mcp">Read the docs</a>
-</p>
+**Let humans be human.**
+
+[Docs](https://contextstream.io/docs/mcp) ·
+[Pricing](https://contextstream.io/pricing) ·
+[Integrations](https://contextstream.io/integrations) ·
+[Benchmarks](https://contextstream.io/benchmarks)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstream/mcp-server",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Verified npm launcher for the open-source ContextStream Rust MCP server",
   "type": "module",
   "license": "MIT",
@@ -45,6 +45,13 @@
     "contextstream",
     "semantic-search",
     "memory",
-    "developer-tools"
+    "developer-tools",
+    "cursor",
+    "claude-code",
+    "codex",
+    "shared-context",
+    "project-context",
+    "mcp-server",
+    "ai-coding"
   ]
 }

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.contextstream/mcp-server",
   "title": "ContextStream MCP Server",
   "description": "Project memory, semantic code search, and grounded agent context.",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "repository": {
     "url": "https://github.com/contextstream/mcp-server",
     "source": "github"
@@ -20,7 +20,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@contextstream/mcp-server",
-      "version": "1.0.6",
+      "version": "1.0.8",
       "transport": {
         "type": "stdio"
       },