Log inSubmit server
MCP Server logo

MCP Server

by contextstream

Persistent MCP memory for code, documents, conversations, decisions, semantic search, graphs, and agent handoffs.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "contextstream-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@contextstream/mcp-server@latest"
      ],
      "env": {
        "CONTEXTSTREAM_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The contextstream/mcp-server MCP server connects coding projects, documentation, and conversations to persistent agent memory. It provides semantic and hybrid search, grounded Q&A with citations, session recall, decision tracking, dependency analysis, and portable context capsules. Use it when agents need workspace knowledge across sessions or tools, rather than only the current prompt. Setup can use the npm launcher or installation scripts, with hosted Streamable HTTP also available for compatible clients.

Use cases

  • Search a workspace for files relevant to a planned change
  • Recall decisions and lessons from previous coding sessions
  • Ask cited questions about indexed project knowledge
  • Analyze dependency impact before refactoring
  • Share a context snapshot during an agent handoff

Key features

  • Semantic, hybrid, keyword, and pattern code search
  • Persistent decisions, documentation, tasks, and transcripts
  • Grounded workspace Q&A with citations
  • Dependency and impact analysis
  • Portable context capsules
  • Entity, skill, and media indexing

Tools9

What MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~149 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · @contextstream/mcp-server@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars44Stargazers on the source repository.
npm downloads7.5kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed9Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server works

What contextstream/mcp-server does

The contextstream/mcp-server MCP server gives coding agents access to persistent project context across sessions. It can connect code, documentation, and conversations so an agent can retrieve relevant files, saved decisions, lessons, plans, and other workspace knowledge. This places it in the 🧠 Knowledge & Memory category, with additional tools for code analysis and work tracking.

Search supports semantic, hybrid, keyword, pattern, exhaustive, and refactor modes. The memory functions cover events, decisions, documents, runbooks, tasks, todos, diagrams, and transcripts. Session features capture decisions and lessons, recall earlier sessions, manage plans, and support retroactive capture. Grounded Q&A can answer over the workspace knowledge base and include citations.

How it works

The server exposes MCP tools through a local installation or a hosted endpoint. Local setup indexes eligible project source contents for hosted search; transcript saving and local Git metadata capture are enabled by default but can be disabled. A hosted connection does not synchronize a local checkout by itself.

Beyond retrieval, the contextstream/mcp-server MCP server can inspect dependency relationships, analyze impact, identify circular dependencies, and find unused code. Capsules provide portable context snapshots for agent handoffs. Entity tools represent tickets, incidents, releases, sprints, OKRs, and risks, while skills package reusable instructions and actions. Media indexing and search covers images, video, audio, and documents.

Setup and configuration

On macOS or Linux, the repository documents an installation script available through curl; Windows uses a PowerShell equivalent. The npm option is npx -y @contextstream/mcp-server@latest setup and requires Node.js 20 or newer. The launcher downloads a platform-specific Rust binary and verifies its SHA-256 checksum. Pin an exact package version for production automation.

Interactive onboarding connects an account, project, and supported editor. For scripted setup, setup --yes can read CONTEXTSTREAM_API_KEY or saved credentials; accounts with multiple workspaces also need a workspace ID. setup --dry-run previews configuration, while doctor --scope=all --only-configured diagnoses configured connections. Account-level learning can be reviewed or changed with the configure command.

A hosted Streamable HTTP endpoint is available at https://mcp.contextstream.io/mcp?default_context_mode=fast for clients that support Streamable HTTP and OAuth. The repository contains the MIT-licensed Rust server, client, editor setup, and release tooling; the hosted backend is separate.

Tools and capabilities

  • Search code and workspace content using semantic, hybrid, keyword, pattern, exhaustive, or refactor modes.
  • Store and retrieve project knowledge, including decisions, runbooks, tasks, transcripts, and diagrams.
  • Capture or recall session decisions, lessons, and plans.
  • Ask cited questions against the workspace knowledge base.
  • Analyze dependencies, change impact, circular dependencies, and unused code.
  • Package handoff context into capsules and manage entities, skills, and media.

Limitations and notes

The contextstream/mcp-server MCP server does not recover every undocumented decision merely by indexing code; those decisions need to be captured. Indexing sends eligible source contents to ContextStream for hosted search, so review the project’s data-handling controls before connecting sensitive repositories. The published benchmark reports a 95 ms median code-search result for its disclosed configuration, but that figure is not a latency guarantee.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server

contextstream/mcp-server is an MCP server that connects code, documentation, and conversations to persistent workspace knowledge. Its main tools provide semantic and hybrid search, memory for decisions and documents, session recall, cited Q&A, dependency and impact analysis, portable context capsules, entity tracking, reusable skills, and media search.

Install it with the documented macOS/Linux or Windows setup script, or run `npx -y @contextstream/mcp-server@latest setup` with Node.js 20 or newer. Follow onboarding to connect a project and editor, then restart the editor after setup.

Yes, contextstream/mcp-server works with Cursor.

Yes, it supports semantic search as well as hybrid, keyword, pattern, exhaustive, and refactor modes. Search is intended to help agents locate relevant workspace files and context.

Yes, it can save and recall decisions, lessons, plans, and other session information. Agents can capture decisions during one session and retrieve them in a later session.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/contextstream-mcp-server?style=directory)](https://allmcps.com/mcp/contextstream-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/contextstream-mcp-server"><img src="https://allmcps.com/api/badge/contextstream-mcp-server?style=directory" alt="MCP Server on AllMCPs" /></a>