@contextstream/mcp-server
v0.4.68
Published
ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.
Maintainers
Readme
npx --prefer-online -y @contextstream/mcp-server@latest setupGet Started (VS Code + Copilot)
Option 1: Rust MCP (recommended)
curl -fsSL https://contextstream.io/scripts/mcp.sh | bashirm https://contextstream.io/scripts/mcp.ps1 | iexThen run:
contextstream-mcp setupOption 2: Node MCP
npx --prefer-online -y @contextstream/mcp-server@latest setupAfter setup, restart VS Code/Copilot.
Works with: Claude Code • Cursor • VS Code • Claude Desktop • Codex CLI • OpenCode • Antigravity
This Isn't Just Memory. This Is Intelligence.
Other tools give your AI a notepad. ContextStream gives it a brain.
Your AI doesn't just remember things—it understands your entire codebase, learns from every conversation, pulls knowledge from your team's GitHub, Slack, and Notion, and delivers exactly the right context at exactly the right moment.
One setup. Instant transformation.
What Changes When You Install This
| Before | After | |--------|-------| | AI searches files one-by-one, burning tokens | Semantic search finds code by meaning in milliseconds | | Context lost when conversations get long | Smart compression preserves what matters before compaction | | Team knowledge scattered across tools | Unified intelligence from GitHub, Slack, Notion—automatically | | Same mistakes repeated across sessions | Lessons system ensures your AI learns from every failure | | Generic responses, no project awareness | Deep context about your architecture, decisions, patterns |
The Power Under the Hood
Semantic Code Intelligence
Ask "where do we handle authentication?" and get the answer instantly. No grep chains. No reading 10 files. Your AI understands your code at a conceptual level.
SmartRouter Context Delivery
Every message is analyzed. Risky refactor? Relevant lessons surface automatically. Making a decision? Your AI knows to capture it. The right context, every time, without you asking.
Team Knowledge Fusion
Connect GitHub, Slack, and Notion. Discussions from months ago? Surfaced when relevant. That architecture decision buried in a PR comment? Your AI knows about it.
Code Graph Analysis
"What depends on UserService?" "What's the impact of changing this function?" Your AI sees the connections across your entire codebase.
Context Pressure Awareness
Long conversation? ContextStream tracks token usage, auto-saves critical state, and ensures nothing important is lost when context compacts.
The Tools Your AI Gets
init → Loads your workspace context instantly
context → Delivers relevant context every single message
search → Semantic, hybrid, keyword—find anything by meaning
session → Captures decisions, preferences, lessons automatically
memory → Builds a knowledge graph of your project
graph → Maps dependencies and analyzes impact
project → Indexes your codebase for semantic understanding
media → Index and search video, audio, images (great for Remotion)
integration → Queries GitHub, Slack, Notion directlyYour AI uses these automatically. You just code.
Manual Configuration
Skip this if you ran the setup wizard.
claude mcp add contextstream -- npx --prefer-online -y @contextstream/mcp-server@latest
claude mcp update contextstream -e CONTEXTSTREAM_API_URL=https://api.contextstream.io -e CONTEXTSTREAM_API_KEY=your_key{
"mcpServers": {
"contextstream": {
"command": "npx",
"args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key"
}
}
}
}Locations: ~/.cursor/mcp.json • ~/Library/Application Support/Claude/claude_desktop_config.json
Local server:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"contextstream": {
"type": "local",
"command": ["npx", "-y", "contextstream-mcp"],
"environment": {
"CONTEXTSTREAM_API_KEY": "{env:CONTEXTSTREAM_API_KEY}"
},
"enabled": true
}
}
}Remote server:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"contextstream": {
"type": "remote",
"url": "https://mcp.contextstream.com",
"enabled": true
}
}
}For the local variant, export CONTEXTSTREAM_API_KEY before launching OpenCode.
Locations: ./opencode.json • ~/.config/opencode/opencode.json
For GitHub Copilot in VS Code, use project-level MCP at .vscode/mcp.json.
Rust MCP (recommended)
{
"servers": {
"contextstream": {
"type": "stdio",
"command": "contextstream-mcp",
"args": [],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key"
}
}
}
}Node MCP server
{
"servers": {
"contextstream": {
"type": "stdio",
"command": "npx",
"args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key"
}
}
}
}Use the Copilot CLI to interactively add the MCP server:
/mcp addOr add to ~/.copilot/mcp-config.json (pick one runtime):
Rust MCP (recommended)
{
"mcpServers": {
"contextstream": {
"command": "contextstream-mcp",
"args": [],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key"
}
}
}
}Node MCP server
{
"mcpServers": {
"contextstream": {
"command": "npx",
"args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key"
}
}
}
}For more information, see the GitHub Copilot CLI documentation.
VS Code + Copilot Tips
- Run setup once and keep both config files:
~/.copilot/mcp-config.json.vscode/mcp.json
- Rust install: use
contextstream-mcpas the command. - Node install: use
npx --prefer-online -y @contextstream/mcp-server@latestas the command. - Use
mcpServersin Copilot CLI config andserversin VS Code config.
Quick Troubleshooting
- Remove duplicate ContextStream entries across Workspace/User config scopes.
- Check
CONTEXTSTREAM_API_URLandCONTEXTSTREAM_API_KEYare set. - Remove stale version pins like
@contextstream/[email protected]. - Restart VS Code/Copilot after config changes.
Marketplace Note
Marketplace npm installs can pin Node MCP versions and do not run external bootstrap scripts (curl ... | bash / irm ... | iex). Use the Rust install command directly when you want the Rust runtime.
Links
Website: https://contextstream.io
Docs: https://contextstream.io/docs
