{"id":35912564,"url":"https://github.com/contextstream/mcp-server","last_synced_at":"2026-04-08T22:01:19.740Z","repository":{"id":329440180,"uuid":"1115350109","full_name":"contextstream/mcp-server","owner":"contextstream","description":"Persistent memory and cross-session learning for AI coding assistants. Cloud-based context management via MCP.","archived":false,"fork":false,"pushed_at":"2026-03-26T18:16:39.000Z","size":42480,"stargazers_count":30,"open_issues_count":0,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-27T07:43:50.333Z","etag":null,"topics":["ai-memory","claude","context-management","cursor","mcp","windsurf"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/contextstream.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-12T18:12:00.000Z","updated_at":"2026-03-26T18:16:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/contextstream/mcp-server","commit_stats":null,"previous_names":["contextstream/mcp-server"],"tags_count":105,"template":false,"template_full_name":null,"purl":"pkg:github/contextstream/mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextstream%2Fmcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextstream%2Fmcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextstream%2Fmcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextstream%2Fmcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/contextstream","download_url":"https://codeload.github.com/contextstream/mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/contextstream%2Fmcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31257008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-31T18:32:52.363Z","status":"ssl_error","status_checked_at":"2026-03-31T18:32:51.507Z","response_time":111,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-memory","claude","context-management","cursor","mcp","windsurf"],"created_at":"2026-01-10T03:40:38.878Z","updated_at":"2026-04-08T22:01:19.722Z","avatar_url":"https://github.com/contextstream.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://contextstream.io/400logo.png\" alt=\"ContextStream\" width=\"80\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eContextStream MCP Server\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eGive your AI coding assistant brilliant memory, deep context, and superpowers it never had.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@contextstream/mcp-server\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@contextstream/mcp-server.svg\" alt=\"npm version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@contextstream/mcp-server\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/@contextstream/mcp-server.svg\" alt=\"downloads\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/contextstream/mcp-server/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/npm/l/@contextstream/mcp-server.svg\" alt=\"license\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://contextstream.io/docs\"\u003eDocumentation\u003c/a\u003e •\n  \u003ca href=\"https://contextstream.io/pricing\"\u003ePricing\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n```bash\nnpx --prefer-online -y @contextstream/mcp-server@latest setup\n```\n\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"compare1.gif\" alt=\"ContextStream in action\" width=\"700\" /\u003e\n\u003c/p\u003e\n\n---\n\n## Get Started (VS Code + Copilot)\n\n### Option 1: Rust MCP (recommended)\n\n```bash\ncurl -fsSL https://contextstream.io/scripts/mcp.sh | bash\n```\n\n```powershell\nirm https://contextstream.io/scripts/mcp.ps1 | iex\n```\n\nThen run:\n\n```bash\ncontextstream-mcp setup\n```\n\n### Option 2: Node MCP\n\n```bash\nnpx --prefer-online -y @contextstream/mcp-server@latest setup\n```\n\nAfter setup, restart VS Code/Copilot.\n\n**Works with:** Claude Code • Cursor • VS Code • Claude Desktop • Codex CLI • OpenCode • Antigravity\n\n---\n\n## This Isn't Just Memory. This Is Intelligence.\n\nOther tools give your AI a notepad. **ContextStream gives it a brain.**\n\nYour 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.\n\n**One setup. Instant transformation.**\n\n---\n\n## What Changes When You Install This\n\n| Before | After |\n|--------|-------|\n| AI searches files one-by-one, burning tokens | **Semantic search** finds code by meaning in milliseconds |\n| Context lost when conversations get long | **Smart compression** preserves what matters before compaction |\n| Team knowledge scattered across tools | **Unified intelligence** from GitHub, Slack, Notion—automatically |\n| Same mistakes repeated across sessions | **Lessons system** ensures your AI learns from every failure |\n| Generic responses, no project awareness | **Deep context** about your architecture, decisions, patterns |\n\n---\n\n## The Power Under the Hood\n\n### Semantic Code Intelligence\nAsk \"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.\n\n### SmartRouter Context Delivery\nEvery 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.\n\n### Team Knowledge Fusion\nConnect GitHub, Slack, and Notion. Discussions from months ago? Surfaced when relevant. That architecture decision buried in a PR comment? Your AI knows about it.\n\n### Code Graph Analysis\n\"What depends on UserService?\" \"What's the impact of changing this function?\" Your AI sees the connections across your entire codebase.\n\n### Context Pressure Awareness\nLong conversation? ContextStream tracks token usage, auto-saves critical state, and ensures nothing important is lost when context compacts.\n\n---\n\n## The Tools Your AI Gets\n\n```\ninit            → Loads your workspace context instantly\ncontext         → Delivers relevant context every single message\nsearch          → Semantic, hybrid, keyword—find anything by meaning\nsession         → Captures decisions, preferences, lessons automatically\nmemory          → Builds a knowledge graph of your project\ngraph           → Maps dependencies and analyzes impact\nproject         → Indexes your codebase for semantic understanding\nmedia           → Index and search video, audio, images (great for Remotion)\nintegration     → Queries GitHub, Slack, Notion directly\n```\n\nYour AI uses these automatically. You just code.\n\n---\n\n## Global Fallback Workspace (Unmapped Folders)\n\nContextStream now supports a catch-all mode for random folders (for example `~` or ad-hoc dirs) that are not associated with a project/workspace yet.\n\n- `init(...)` resolves normal folder mappings first (`.contextstream/config.json`, parent/global mappings).\n- If no mapping exists, it uses a single hidden global fallback workspace (`.contextstream-global`) in workspace-only mode.\n- Context/memory/session tools continue to work without hard setup errors.\n- Project-bound actions (for example `project(action=\"ingest_local\")`) return guided remediation to create/select a project instead of failing with a raw `project_id required` error.\n- As soon as you enter a mapped project folder, that real workspace/project is prioritized and replaces fallback scope.\n\n---\n\n## Manual Configuration\n\n\u003e Skip this if you ran the setup wizard.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eClaude Code\u003c/b\u003e\u003c/summary\u003e\n\n```bash\nclaude mcp add contextstream -- npx --prefer-online -y @contextstream/mcp-server@latest\nclaude mcp update contextstream -e CONTEXTSTREAM_API_URL=https://api.contextstream.io -e CONTEXTSTREAM_API_KEY=your_key\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCursor / Claude Desktop\u003c/b\u003e\u003c/summary\u003e\n\n```json\n{\n  \"mcpServers\": {\n    \"contextstream\": {\n      \"command\": \"npx\",\n      \"args\": [\"--prefer-online\", \"-y\", \"@contextstream/mcp-server@latest\"],\n      \"env\": {\n        \"CONTEXTSTREAM_API_URL\": \"https://api.contextstream.io\",\n        \"CONTEXTSTREAM_API_KEY\": \"your_key\"\n      }\n    }\n  }\n}\n```\n\n**Locations:** `~/.cursor/mcp.json` • `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eOpenCode\u003c/b\u003e\u003c/summary\u003e\n\nLocal server:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"contextstream\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"contextstream-mcp\"],\n      \"environment\": {\n        \"CONTEXTSTREAM_API_KEY\": \"{env:CONTEXTSTREAM_API_KEY}\"\n      },\n      \"enabled\": true\n    }\n  }\n}\n```\n\nRemote server:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"contextstream\": {\n      \"type\": \"remote\",\n      \"url\": \"https://mcp.contextstream.com\",\n      \"enabled\": true\n    }\n  }\n}\n```\n\nFor the local variant, export `CONTEXTSTREAM_API_KEY` before launching OpenCode.\n\n**Locations:** `./opencode.json` • `~/.config/opencode/opencode.json`\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eVS Code\u003c/b\u003e\u003c/summary\u003e\n\nFor GitHub Copilot in VS Code, the easiest path is the hosted remote MCP with built-in OAuth. Marketplace installs should write this remote server definition automatically.\n\n**Hosted remote MCP (recommended)**\n\n```json\n{\n  \"servers\": {\n    \"contextstream\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.contextstream.io/mcp?default_context_mode=fast\"\n    }\n  }\n}\n```\n\nOn first use, VS Code should prompt you to authorize ContextStream in the browser and then complete setup without an API key in the config file.\n\n`npx @contextstream/mcp-server@latest setup` now defaults VS Code/Copilot to this hosted remote when you are using the production ContextStream cloud. To force a local runtime instead, run setup with `CONTEXTSTREAM_VSCODE_MCP_MODE=local`.\n\nFor self-hosted or non-default API deployments, local runtime remains the default:\n\n**Rust MCP (recommended)**\n\n```json\n{\n  \"servers\": {\n    \"contextstream\": {\n      \"type\": \"stdio\",\n      \"command\": \"contextstream-mcp\",\n      \"args\": [],\n      \"env\": {\n        \"CONTEXTSTREAM_API_URL\": \"https://api.contextstream.io\",\n        \"CONTEXTSTREAM_API_KEY\": \"your_key\",\n        \"CONTEXTSTREAM_TOOLSET\": \"complete\",\n        \"CONTEXTSTREAM_TRANSCRIPTS_ENABLED\": \"true\",\n        \"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED\": \"true\",\n        \"CONTEXTSTREAM_SEARCH_LIMIT\": \"15\",\n        \"CONTEXTSTREAM_SEARCH_MAX_CHARS\": \"2400\"\n      }\n    }\n  }\n}\n```\n\n**Node MCP server**\n\n```json\n{\n  \"servers\": {\n    \"contextstream\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"--prefer-online\", \"-y\", \"@contextstream/mcp-server@latest\"],\n      \"env\": {\n        \"CONTEXTSTREAM_API_URL\": \"https://api.contextstream.io\",\n        \"CONTEXTSTREAM_API_KEY\": \"your_key\",\n        \"CONTEXTSTREAM_TOOLSET\": \"complete\",\n        \"CONTEXTSTREAM_TRANSCRIPTS_ENABLED\": \"true\",\n        \"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED\": \"true\",\n        \"CONTEXTSTREAM_SEARCH_LIMIT\": \"15\",\n        \"CONTEXTSTREAM_SEARCH_MAX_CHARS\": \"2400\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGitHub Copilot CLI\u003c/b\u003e\u003c/summary\u003e\n\nUse the Copilot CLI to interactively add the MCP server:\n\n```bash\n/mcp add\n```\n\nOr add to `~/.copilot/mcp-config.json` (pick one runtime):\n\n**Rust MCP (recommended)**\n\n```json\n{\n  \"mcpServers\": {\n    \"contextstream\": {\n      \"command\": \"contextstream-mcp\",\n      \"args\": [],\n      \"env\": {\n        \"CONTEXTSTREAM_API_URL\": \"https://api.contextstream.io\",\n        \"CONTEXTSTREAM_API_KEY\": \"your_key\",\n        \"CONTEXTSTREAM_TOOLSET\": \"complete\",\n        \"CONTEXTSTREAM_TRANSCRIPTS_ENABLED\": \"true\",\n        \"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED\": \"true\",\n        \"CONTEXTSTREAM_SEARCH_LIMIT\": \"15\",\n        \"CONTEXTSTREAM_SEARCH_MAX_CHARS\": \"2400\"\n      }\n    }\n  }\n}\n```\n\n**Node MCP server**\n\n```json\n{\n  \"mcpServers\": {\n    \"contextstream\": {\n      \"command\": \"npx\",\n      \"args\": [\"--prefer-online\", \"-y\", \"@contextstream/mcp-server@latest\"],\n      \"env\": {\n        \"CONTEXTSTREAM_API_URL\": \"https://api.contextstream.io\",\n        \"CONTEXTSTREAM_API_KEY\": \"your_key\",\n        \"CONTEXTSTREAM_TOOLSET\": \"complete\",\n        \"CONTEXTSTREAM_TRANSCRIPTS_ENABLED\": \"true\",\n        \"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED\": \"true\",\n        \"CONTEXTSTREAM_SEARCH_LIMIT\": \"15\",\n        \"CONTEXTSTREAM_SEARCH_MAX_CHARS\": \"2400\"\n      }\n    }\n  }\n}\n```\n\nFor more information, see the [GitHub Copilot CLI documentation](https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli).\n\n\u003c/details\u003e\n\n---\n\n## VS Code + Copilot Tips\n\n- Run setup once and keep both config files:\n  - `~/.copilot/mcp-config.json`\n  - `.vscode/mcp.json`\n- Rust install: use `contextstream-mcp` as the command.\n- Node install: use `npx --prefer-online -y @contextstream/mcp-server@latest` as the command.\n- Force local VS Code/Copilot setup with `CONTEXTSTREAM_VSCODE_MCP_MODE=local`.\n- Force hosted remote VS Code/Copilot setup with `CONTEXTSTREAM_VSCODE_MCP_MODE=remote`.\n- Use `mcpServers` in Copilot CLI config and `servers` in VS Code config.\n\n## Quick Troubleshooting\n\n- Remove duplicate ContextStream entries across Workspace/User config scopes.\n- Check `CONTEXTSTREAM_API_URL` and `CONTEXTSTREAM_API_KEY` are set.\n- Remove stale version pins like `@contextstream/mcp-server@0.3.xx`.\n- Restart VS Code/Copilot after config changes.\n\n## Known Limitations\n\n### HTTP transport OAuth and vscode.dev dependency\n\nThe hosted HTTP MCP transport (`https://mcp.contextstream.io/mcp`) uses OAuth authentication that routes through `vscode.dev` for the redirect flow. This can fail in environments where `vscode.dev` is blocked (corporate networks, regional restrictions, CDN-level blocks).\n\n**Workaround:** Use the stdio transport (Rust binary or Node.js) with API key authentication instead:\n\n```json\n{\n  \"contextstream\": {\n    \"type\": \"stdio\",\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@contextstream/mcp-server@latest\"],\n    \"env\": {\n      \"CONTEXTSTREAM_API_KEY\": \"your-api-key\"\n    }\n  }\n}\n```\n\n### SDK version compatibility\n\n`@modelcontextprotocol/sdk` versions 1.28.0 and above introduce breaking changes. The `package.json` pins the SDK to `\u003e=1.25.1 \u003c1.28.0` to prevent incompatible resolutions. If you experience Zod schema errors on startup, ensure your SDK version is below 1.28.0.\n\n## Marketplace Note\n\nThe MCP marketplace entry now targets the hosted remote MCP at `https://mcp.contextstream.io/mcp?default_context_mode=fast` so VS Code can use the native OAuth flow instead of writing a local npm-based stdio config.\n\nUse the Rust or Node local runtime configs above only when you explicitly want local execution, custom/self-hosted endpoints, or editor environments that do not support the hosted remote flow.\n\n---\n\n## Links\n\n**Website:** https://contextstream.io\n\n**Docs:** https://contextstream.io/docs\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eStop teaching your AI the same things over and over.\u003c/strong\u003e\u003cbr/\u003e\n  \u003csub\u003eContextStream makes it brilliant from the first message.\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontextstream%2Fmcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontextstream%2Fmcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontextstream%2Fmcp-server/lists"}