npm - @contextstream/mcp-server - Versions diffs - 1.0.7 → 1.0.9 - Mend

@contextstream/mcp-server 1.0.7 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md CHANGED Viewed

@@ -1,286 +1,141 @@
 <!-- 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, GitHub Copilot, Gemini CLI, Qwen Code,
+Kimi Code, Muse Code, ZCode, Zed, and [more MCP clients](docs/clients.md), on
+Claude, GPT, Gemini, Kimi, GLM, Qwen, and other models.
+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) ·
+[Supported clients](docs/clients.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.
+[Supported clients](docs/clients.md) lists one-line add commands for Claude
+Code, Codex, Gemini CLI, Qwen Code, Copilot CLI, and Droid, and one-click
+install for VS Code. Use the [MCP documentation](https://contextstream.io/docs/mcp)
+for other clients 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 CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstream/mcp-server",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Verified npm launcher for the open-source ContextStream Rust MCP server",
   "type": "module",
   "license": "MIT",
@@ -45,6 +45,33 @@
     "contextstream",
     "semantic-search",
     "memory",
-    "developer-tools"
+    "developer-tools",
+    "cursor",
+    "claude-code",
+    "codex",
+    "shared-context",
+    "project-context",
+    "mcp-server",
+    "ai-coding",
+    "kimi",
+    "kimi-code",
+    "glm",
+    "zai",
+    "zcode",
+    "qwen-code",
+    "gemini-cli",
+    "muse-code",
+    "zed",
+    "windsurf",
+    "copilot",
+    "copilot-cli",
+    "opencode",
+    "crush",
+    "amp",
+    "factory-droid",
+    "cline",
+    "kilo-code",
+    "antigravity",
+    "claude-desktop"
   ]
 }

package/server.json CHANGED Viewed

@@ -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.7",
+  "version": "1.0.9",
   "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.7",
+      "version": "1.0.9",
       "transport": {
         "type": "stdio"
       },