ContextStream MCP Server
npx --prefer-online -y @contextstream/mcp-server@latest setup入门指南 (VS Code + Copilot)
选项 1:Rust MCP (推荐)
curl -fsSL https://contextstream.io/scripts/mcp.sh | bashirm https://contextstream.io/scripts/mcp.ps1 | iex然后运行:
contextstream-mcp setup选项 2:Node MCP
npx --prefer-online -y @contextstream/mcp-server@latest setup设置完成后,重启 VS Code/Copilot。
兼容: Claude Code • Cursor • VS Code • Claude Desktop • Codex CLI • OpenCode • Antigravity
这不仅仅是记忆,这是智能。
其他工具只是给你的 AI 提供了一个记事本。ContextStream 赋予了它大脑。
你的 AI 不仅仅是记住事情——它能理解你的整个代码库,从每一次对话中学习,从团队的 GitHub、Slack 和 Notion 中提取知识,并在最恰当的时机提供最准确的上下文。
一次设置,即刻蜕变。
安装后的变化
之前 | 之后 |
AI 逐个搜索文件,消耗大量 Token | 语义搜索在毫秒内按含义查找代码 |
对话变长时上下文丢失 | 智能压缩在压缩前保留关键信息 |
团队知识分散在各个工具中 | 统一智能自动整合 GitHub、Slack、Notion 的知识 |
在不同会话中重复犯错 | 经验系统确保 AI 从每一次失败中学习 |
通用回复,缺乏项目感知 | 深度上下文了解你的架构、决策和模式 |
核心能力
语义代码智能
询问“我们在哪里处理身份验证?”并立即获得答案。无需 grep 链,无需阅读 10 个文件。你的 AI 从概念层面理解你的代码。
SmartRouter 上下文交付
分析每一条消息。有风险的重构?自动呈现相关经验。做出决策?你的 AI 知道将其捕获。无需你询问,在最恰当的时候提供最准确的上下文。
团队知识融合
连接 GitHub、Slack 和 Notion。几个月前的讨论?在相关时自动呈现。埋在 PR 评论中的架构决策?你的 AI 了如指掌。
代码图谱分析
“什么依赖于 UserService?”“更改此函数的影响是什么?”你的 AI 可以看到整个代码库中的连接。
上下文压力感知
对话太长?ContextStream 会跟踪 Token 使用情况,自动保存关键状态,并确保在上下文压缩时不会丢失任何重要信息。
你的 AI 获得的工具
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 directly你的 AI 会自动使用这些工具。你只需专注于编码。
全局回退工作区 (未映射文件夹)
ContextStream 现在支持针对随机文件夹(例如 ~ 或临时目录)的“全捕获”模式,这些文件夹尚未关联到项目/工作区。
init(...)首先解析常规文件夹映射(.contextstream/config.json,父级/全局映射)。如果不存在映射,它将在仅工作区模式下使用一个隐藏的全局回退工作区 (
.contextstream-global)。上下文/记忆/会话工具无需复杂的设置错误即可继续工作。
项目绑定操作(例如
project(action="ingest_local"))会返回引导式修复建议,要求创建/选择项目,而不是直接报错project_id required。一旦你进入已映射的项目文件夹,该真实工作区/项目将被优先处理并替换回退范围。
手动配置
如果你已经运行了设置向导,请跳过此步骤。
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"
}
}
}
}位置: ~/.cursor/mcp.json • ~/Library/Application Support/Claude/claude_desktop_config.json
本地服务器:
{
"$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
}
}
}远程服务器:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"contextstream": {
"type": "remote",
"url": "https://mcp.contextstream.com",
"enabled": true
}
}
}对于本地变体,请在启动 OpenCode 之前导出 CONTEXTSTREAM_API_KEY。
位置: ./opencode.json • ~/.config/opencode/opencode.json
对于 VS Code 中的 GitHub Copilot,最简单的路径是使用内置 OAuth 的托管远程 MCP。市场安装程序应自动写入此远程服务器定义。
托管远程 MCP (推荐)
{
"servers": {
"contextstream": {
"type": "http",
"url": "https://mcp.contextstream.io/mcp?default_context_mode=fast"
}
}
}首次使用时,VS Code 应提示你在浏览器中授权 ContextStream,然后无需在配置文件中输入 API 密钥即可完成设置。
npx @contextstream/mcp-server@latest setup 现在默认将 VS Code/Copilot 指向此托管远程服务器(当你使用生产环境 ContextStream 云时)。若要强制使用本地运行时,请运行 CONTEXTSTREAM_VSCODE_MCP_MODE=local 进行设置。
对于自托管或非默认 API 部署,本地运行时仍然是默认设置:
Rust MCP (推荐)
{
"servers": {
"contextstream": {
"type": "stdio",
"command": "contextstream-mcp",
"args": [],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}Node MCP 服务器
{
"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",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}使用 Copilot CLI 以交互方式添加 MCP 服务器:
/mcp add或者添加到 ~/.copilot/mcp-config.json (选择一种运行时):
Rust MCP (推荐)
{
"mcpServers": {
"contextstream": {
"command": "contextstream-mcp",
"args": [],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}Node MCP 服务器
{
"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",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}更多信息,请参阅 GitHub Copilot CLI 文档。
VS Code + Copilot 提示
运行一次设置并保留两个配置文件:
~/.copilot/mcp-config.json.vscode/mcp.json
Rust 安装:使用
contextstream-mcp作为命令。Node 安装:使用
npx --prefer-online -y @contextstream/mcp-server@latest作为命令。使用
CONTEXTSTREAM_VSCODE_MCP_MODE=local强制进行本地 VS Code/Copilot 设置。使用
CONTEXTSTREAM_VSCODE_MCP_MODE=remote强制进行托管远程 VS Code/Copilot 设置。在 Copilot CLI 配置中使用
mcpServers,在 VS Code 配置中使用servers。
快速故障排除
删除工作区/用户配置范围中重复的 ContextStream 条目。
检查是否设置了
CONTEXTSTREAM_API_URL和CONTEXTSTREAM_API_KEY。删除过时的版本锁定,如
@contextstream/mcp-server@0.3.xx。配置更改后重启 VS Code/Copilot。
已知限制
HTTP 传输 OAuth 和 vscode.dev 依赖
托管的 HTTP MCP 传输 (https://mcp.contextstream.io/mcp) 使用 OAuth 身份验证,该验证通过 vscode.dev 进行重定向流。在 vscode.dev 被阻止的环境(企业网络、区域限制、CDN 级阻止)中,这可能会失败。
解决方法: 使用 stdio 传输(Rust 二进制文件或 Node.js)并改用 API 密钥身份验证:
{
"contextstream": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_KEY": "your-api-key"
}
}
}SDK 版本兼容性
@modelcontextprotocol/sdk 1.28.0 及以上版本引入了破坏性变更。package.json 将 SDK 锁定在 >=1.25.1 <1.28.0 以防止不兼容的解析。如果你在启动时遇到 Zod 模式错误,请确保你的 SDK 版本低于 1.28.0。
市场说明
MCP 市场条目现在指向 https://mcp.contextstream.io/mcp?default_context_mode=fast 的托管远程 MCP,以便 VS Code 可以使用原生 OAuth 流,而不是编写本地基于 npm 的 stdio 配置。
仅当你明确需要本地执行、自定义/自托管端点或不支持托管远程流的编辑器环境时,才使用上述 Rust 或 Node 本地运行时配置。
链接
文档: https://contextstream.io/docs
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/contextstream/mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server