适合谁
- 使用 Claude Code、Cursor、Windsurf 等工具的长期项目开发者
- 需要跨会话记忆和代码库理解的团队
C
73FMRS · B
功能全面的记忆与代码搜索 MCP 服务器，setup 向导覆盖主流编辑器，提供免费层；核心价值在于跨会话记忆、语义搜索和上下文压缩保护，但依赖云服务和 API 密钥。
ContextStream MCP 服务器为 Claude Code、Cursor、VS Code Copilot、Windsurf 等 MCP 兼容的 AI 编程助手提供持久化记忆、语义代码搜索和跨会话学习。它对代码库建立索引、记录决策与经验教训、映射依赖图，并整合 GitHub、Slack、Notion 团队知识。据官方基准，其在 LongMemEval-S（完整 500 实例、官方 GPT-4o 评审）上得分为 90.0%。
工具能力
init
获取工作区状态并为每条消息准备上下文
context
在每条消息上提供恰当的工作区上下文
search
语义、混合、关键词、模式、穷尽和重构模式的代码搜索
memory
管理事件、决策、文档、运行手册、任务、待办、图表和会话记录
session
捕获决策与经验教训、回顾过往会话与计划
qa
基于工作区知识库的问答，附引用出处
graph
依赖映射、影响分析、循环依赖与死代码检测
capsule
打包可移植、可分享的上下文快照用于智能体交接
entity
管理工单、事故、发布、冲刺、OKR 和风险
project
项目索引、范围与去索引管理
workspace
工作区管理
skill
可跨工具移植的指令与操作捆绑包
media
索引并搜索图像、视频、音频和文档
vcs
仓库链接管理
reminder
提醒功能
integration
第三方集成管理
help
诊断与版本信息
安装接入
运行 npx --prefer-online -y @contextstream/mcp-server@latest setup 自动配置编辑器；或手动在 MCP 配置中添加 npx 启动项并设置 CONTEXTSTREAM_API_KEY（必需）和 CONTEXTSTREAM_API_URL（可选，默认 https://api.contextstream.io）。也可使用托管远程端点 https://mcp.contextstream.io/mcp（streamable-http，支持 OAuth）。
claude_desktop_config.json
{"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 API 密钥（敏感环境变量）
- 读取并索引项目代码文件
- 可配置 GitHub、Slack、Notion 集成
- 可在编辑器配置中写入 MCP 配置、规则和生命周期钩子
风险与副作用
- 代码索引数据存储于 ContextStream 云端（官方称按工作区隔离）
- API 密钥泄露可能暴露工作区数据
- 与 @modelcontextprotocol/sdk 1.28.0+ 存在兼容性问题
- 托管 HTTP 的 OAuth 在企业网络可能被阻断
常见排障
- 运行 contextstream-mcp doctor 检查认证、索引健康、规则和钩子
- 确认 CONTEXTSTREAM_API_URL 与 CONTEXTSTREAM_API_KEY 已设置
- 移除过期版本固定如 @contextstream/[email protected]
- 配置更改后重启编辑器
- 网络阻断 OAuth 时改用 stdio + API 密钥
- 若 Zod 报错检查 SDK 版本解析
使用场景
跨会话记住决策、计划和经验教训
语义搜索大型代码库
上下文压缩前自动保存关键状态
团队知识整合与带引用的问答
智能体之间的上下文交接
支持客户端
Claude Code完整支持
Cursor完整支持
Windsurf完整支持
Cline完整支持
Roo Code完整支持
VS Code + GitHub Copilot部分支持
Kilo Code部分支持
Codex CLI部分支持
OpenCode部分支持
Aider部分支持
Antigravity部分支持
Claude Desktop部分支持