Sponsored by Deepsite.site

Contextstream

Created By
ContextStream7 days ago
Persistent memory for AI coding assistants. Works across Cursor, Claude, Windsurf, VS Code and any MCP client. Remember decisions, search semantically, analyze code dependencies — 60+ tools. Your AI's permanent brain.
Content
⚠️

@contextstream/mcp-server

0.3.13 • Public • Published

ContextStream MCP Server

npm version

🧠 Your AI's Permanent Brain — Across Every Tool, Every Conversation

Tired of re-explaining your codebase to AI every single time?

ContextStream gives your AI persistent memory that follows you everywhere. Decisions remembered. Context preserved. No more repeating yourself.

Website: contextstream.io | Docs: contextstream.io/docs/mcp


✨ Why ContextStream?

The Problem

  • Close a chat with Cursor → Open a new one → AI forgot everything
  • Switch from Claude to Windsurf → Start explaining from scratch
  • New team member joins → Days of onboarding conversations
  • "Why did we build it this way?" → No one remembers

The Solution

ContextStream is a universal memory layer for AI coding tools. It works with Cursor, Claude Code, Windsurf, VS Code, and any MCP-compatible client.

You: "Initialize session and remember we use PostgreSQL with TypeScript strict mode"
...later, in a NEW conversation...
You: "What are my preferences for this project?"
AI: "You prefer TypeScript with strict mode, and you're using PostgreSQL."

It remembers. Across sessions. Across tools. Forever.


🚀 2-Minute Setup

1. Get your API key (30 seconds)

Sign up at contextstream.io → Settings → API Keys → Create one.

2. Add to your MCP config (60 seconds)

Cursor / Claude Code / Windsurf / VS Code:

{
  "mcpServers": {
    "contextstream": {
      "command": "npx",
      "args": ["-y", "@contextstream/mcp-server"],
      "env": {
        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
        "CONTEXTSTREAM_API_KEY": "your_api_key"
      }
    }
  }
}

Codex CLI: Add to ~/.codex/config.toml:

[mcpServers.contextstream]
command = "npx"
args = ["-y", "@contextstream/mcp-server"]

[mcpServers.contextstream.env] CONTEXTSTREAM_API_URL = "https://api.contextstream.io" CONTEXTSTREAM_API_KEY = "your_api_key"

3. Try it out (30 seconds)

Start a chat and say:

"Initialize session and remember that I prefer TypeScript with strict mode"

Then start a brand new conversation and ask:

"What are my preferences?"

It remembers.


🔥 Beyond Memory — That's Just the Beginning

ContextStream isn't just memory storage. It understands your code.

Impact Analysis

"What breaks if I change the UserService class?"

See all dependencies and side effects before refactoring.

Decision History

"Why did we choose PostgreSQL over MongoDB?"

Recall past decisions with full context and reasoning.

"Find where we handle rate limiting"

Search by meaning, not just keywords. Find code by intent.

Knowledge Graph

"Show dependencies for the auth module"

Visualize connections between code, decisions, and docs.


📊 60+ MCP Tools at Your Fingertips

🔍 Code Search & Context

ToolDescription
search_semanticFind code by meaning, not just keywords
search_hybridCombines semantic + keyword for best results
search_patternRegex-based code search
ai_contextAutomatically gather relevant code, docs, and memory

🧠 Memory & Knowledge

ToolDescription
session_rememberQuick natural language memory ("Remember I prefer TypeScript")
session_recallQuick recall ("What were the auth decisions?")
memory_create_eventStore decisions, insights, and context
memory_searchFind relevant past context
memory_decisionsGet decision summaries

📊 Code Intelligence

ToolDescription
graph_dependenciesUnderstand what depends on what
graph_call_pathTrace execution flows
graph_impactUnderstand change impact
graph_circular_dependenciesFind problematic cycles
graph_unused_codeIdentify dead code

🤖 AI Integration

ToolDescription
ai_contextBuild LLM-ready context from your codebase
ai_enhanced_contextDeep analysis with memory integration
ai_planAI-powered development planning
ai_tasksBreak down work into actionable tasks

🚀 Session Management

ToolDescription
session_initInitialize conversation with auto-context
context_smartGet relevant context for any message
session_captureStore context to memory
session_compressCompress chat history to memory

See all 60+ tools →


✨ Auto-Context (v0.3.0+)

Context loads automatically on the first tool call. No manual setup required.

═══════════════════════════════════════════
🧠 AUTO-CONTEXT LOADED (ContextStream)
═══════════════════════════════════════════
📁 Workspace: my-project
📂 Project: backend-api

📋 Recent Decisions:

• Use PostgreSQL for persistence

• JWT for authentication

🧠 Recent Context: • [decision] API design patterns • [preference] TypeScript strict mode ═══════════════════════════════════════════

Works with all MCP clients — no client-side changes required.


🛡️ Privacy & Security

  • Encrypted at rest — All data encrypted with AES-256
  • No training on your data — We never use your code to train AI
  • You control access — Workspace permissions & API keys
  • Self-host option — Enterprise can self-host for full control

🏆 Why Not Built-in Memory?

Built-in memoryContextStream
✗ Vendor lock-in — switch tools, lose everythingUniversal — Cursor, Claude, Windsurf, any MCP tool
✗ Expires or resets over timePersistent forever — never lose context (paid plans)
✗ No semantic searchSemantic search — find anything across all history
✗ Personal only — teammates start from zeroTeam memory — shared context, instant onboarding
✗ No API access60+ MCP tools — full API and automation
✗ Memory isolated from codeKnowledge graph — decisions linked to code
✗ Clunky to useNatural language — "remember X", "what did we decide about Y?"

📖 Full Tool Reference

Authentication
ToolDescription
auth_meGet current user profile
Workspaces
ToolDescription
workspaces_listList accessible workspaces
workspaces_getGet workspace details
workspaces_createCreate a new workspace
workspaces_overviewGet workspace summary
workspaces_analyticsGet usage analytics
workspaces_contentList workspace content
Projects
ToolDescription
projects_listList projects (by workspace)
projects_getGet project details
projects_createCreate a new project
projects_overviewGet project summary
projects_statisticsGet code statistics
projects_filesList indexed files
projects_indexTrigger re-indexing
projects_index_statusCheck indexing status
Search
ToolDescription
search_semanticSemantic vector search
search_hybridCombined semantic + keyword
search_keywordTraditional keyword search
search_patternRegex pattern search
search_suggestionsGet search suggestions
Memory
ToolDescription
memory_create_eventStore a memory event
memory_get_eventRetrieve an event
memory_update_eventUpdate an event
memory_delete_eventRemove an event
memory_list_eventsList events in workspace
memory_bulk_ingestBulk import events
memory_distill_eventExtract key insights
memory_create_nodeCreate knowledge node
memory_get_nodeGet knowledge node
memory_update_nodeUpdate knowledge node
memory_delete_nodeRemove knowledge node
memory_supersede_nodeReplace with new version
memory_list_nodesList knowledge nodes
memory_searchSearch memory
memory_decisionsGet decision summaries
memory_timelineGet chronological timeline
memory_summaryGet condensed summary
Graph Analysis
ToolDescription
graph_relatedFind related knowledge nodes
graph_pathFind path between nodes
graph_decisionsDecision history in graph
graph_dependenciesQuery code dependencies
graph_call_pathTrace call paths
graph_impactAnalyze change impact
graph_circular_dependenciesFind circular deps
graph_unused_codeFind dead code
graph_contradictionsFind conflicting info
AI
ToolDescription
ai_contextBuild LLM context
ai_enhanced_contextDeep context with memory
ai_embeddingsGenerate embeddings
ai_planGenerate dev plan
ai_tasksGenerate tasks
Session & Auto-Context
ToolDescription
session_initInitialize conversation
session_get_user_contextGet user preferences
session_captureStore context to memory
session_smart_searchSearch with context enrichment
session_rememberQuick natural language memory
session_recallQuick natural language recall
context_smartGet relevant context for message
session_compressCompress chat history to memory
session_summaryGet compact workspace summary
session_deltaGet changes since timestamp

🔌 Pre-built Prompts

PromptDescription
explore-codebaseGet a codebase overview
capture-decisionDocument an ADR
review-contextBuild code review context
investigate-bugDebug investigation helper
explore-knowledgeNavigate knowledge graph
onboard-to-projectGenerate onboarding guide
analyze-refactoringFind refactoring opportunities
build-contextBuild comprehensive LLM context

⚙️ Environment Variables

VariableRequiredDescription
CONTEXTSTREAM_API_URLYesAPI base URL (https://api.contextstream.io)
CONTEXTSTREAM_API_KEYYesYour API key from contextstream.io


📄 License

MIT

Server Config

{
  "mcpServers": {
    "contextstream": {
      "command": "npx",
      "args": [
        "-y",
        "@contextstream/mcp-server"
      ],
      "env": {
        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
        "CONTEXTSTREAM_API_KEY": "your_api_key"
      }
    }
  }
}
Recommend Servers
TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.
MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.
BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.
ChatWiseThe second fastest AI chatbot™
Baidu Map百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.
Howtocook Mcp基于Anduin2017 / HowToCook (程序员在家做饭指南)的mcp server,帮你推荐菜谱、规划膳食,解决“今天吃什么“的世纪难题; Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"
MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs
TimeA Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.
Context7Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors
CursorThe AI Code Editor
Playwright McpPlaywright MCP server
AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.
Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.
Serper MCP ServerA Serper MCP Server
DeepChatYour AI Partner on Desktop
Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code
Amap Maps高德地图官方 MCP Server
WindsurfThe new purpose-built IDE to harness magic
Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.
Tavily Mcp