← 返回目录

ContextStream MCP Server

官方

为 AI 编程助手提供持久记忆与语义代码搜索

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 10 / 438
Stars: ★ 44 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 4 天前
工具数: 17

73FMRS · B

功能全面的记忆与代码搜索 MCP 服务器，setup 向导覆盖主流编辑器，提供免费层；核心价值在于跨会话记忆、语义搜索和上下文压缩保护，但依赖云服务和 API 密钥。

最强项 · 文档质量 18/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

15/20

维护活跃度

15/20

文档质量

18/20

安装易用性

15/20

查看各项评分依据

可靠性 10/20: 根据静态分析，该MCP服务器具有基本的结构完整性，但缺乏可验证的执行证据。服务器清单显示版本1.0.4和明确的工具定义，但没有提供CI工作流程或测试覆盖关键路径的证据。考虑到这是一个静态分析，无法验证启动和工具握手过程的可靠性。
安全与权限 15/20: 凭据处理良好，需要CONTEXTSTREAM_API_KEY环境变量，并标记为isSecret。数据边界通过workspace_id概念实现，外部网络调用通过API_URL配置。没有发现明显的危险操作默认值，但缺乏对数据加密和访问控制的详细说明。
维护活跃度 15/20: 项目有39个星标，0个开放问题，未归档。MIT许可证清晰。版本历史记录显示持续更新，但缺乏安全响应通道的具体信息。依赖项更新路径不明确，因为没有package.文件进行审查。
文档质量 18/20: 文档非常详细，包括安装说明、配置示例、故障排除指南和工具描述。提供了针对多个编辑器的具体配置说明。虽然文档很全面，但缺乏对限制和成本的明确披露。
安装易用性 15/20: 提供了setup命令，支持交互式和零提示模式。为多个编辑器提供了配置示例，显示了平台兼容性。然而，由于是静态分析，无法验证实际安装过程的顺利程度。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

使用 Claude Code、Cursor、Windsurf 等工具的长期项目开发者
需要跨会话记忆和代码库理解的团队

不适合谁

不愿将代码索引到云端的使用者
不需要持久化上下文的一次性脚本场景

所需权限

需要 ContextStream API 密钥（敏感环境变量）
读取并索引项目代码文件
可配置 GitHub、Slack、Notion 集成
可在编辑器配置中写入 MCP 配置、规则和生命周期钩子

风险与副作用

代码索引数据存储于 ContextStream 云端（官方称按工作区隔离）
API 密钥泄露可能暴露工作区数据
与 @modelcontextprotocol/sdk 1.28.0+ 存在兼容性问题
托管 HTTP 的 OAuth 在企业网络可能被阻断

安装接入

准备工作

运行环境：Node.js · 远程托管（无需本地环境）

CONTEXTSTREAM_API_KEY 必填密钥 ContextStream API 密钥，必需的私密凭据；从 contextstream.io 注册获取（免费层可用）。

其他可选配置项（4 个）

CONTEXTSTREAM_API_URL 可选 ContextStream API 的基础地址，可选，默认 https://api.contextstream.io。

CONTEXTSTREAM_TOOLSET 可选控制注册的工具集范围，示例配置中设为 complete。

CONTEXTSTREAM_HOOK_ENABLED 可选设为 false 可禁用编辑器生命周期钩子。

CONTEXTSTREAM_VSCODE_MCP_MODE 可选设为 local 可强制 VS Code/Copilot 使用本地运行时而非托管远程服务。

运行 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）。

.mcp.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"}}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "contextstream": {
      "command": "npx",
      "args": [
        "--prefer-online",
        "-y",
        "@contextstream/mcp-server@latest"
      ],
      "env": {
        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
        "CONTEXTSTREAM_API_KEY": "your_key"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add contextstream -e CONTEXTSTREAM_API_URL=https://api.contextstream.io -e CONTEXTSTREAM_API_KEY=your_key -- npx --prefer-online -y @contextstream/mcp-server@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 `npx --prefer-online -y @contextstream/mcp-server@latest setup` 并重启编辑器，然后确认客户端工具列表中出现 contextstream 的工具（如 search、context、memory），或调用 help(action="version") 返回版本信息。

常见排障

运行 contextstream-mcp doctor 检查认证、索引健康、规则和钩子
确认 CONTEXTSTREAM_API_URL 与 CONTEXTSTREAM_API_KEY 已设置
移除过期版本固定如 @contextstream/[email protected]
配置更改后重启编辑器
网络阻断 OAuth 时改用 stdio + API 密钥
若 Zod 报错检查 SDK 版本解析

试试这样问

连接成功后，可以直接对 AI 助手这样说：

我们在哪里处理身份验证？
上周我们关于 id 格式做了什么决定？
哪些模块依赖 UserService？
如果我改这个函数，会影响什么？

工具能力 17

init 写入

获取工作区状态并为每条消息准备上下文

context 只读

在每条消息上提供恰当的工作区上下文

search 只读

语义、混合、关键词、模式、穷尽和重构模式的代码搜索

memory 写入

管理事件、决策、文档、运行手册、任务、待办、图表和会话记录

session 写入

捕获决策与经验教训、回顾过往会话与计划

qa 只读

基于工作区知识库的问答，附引用出处

graph 只读

依赖映射、影响分析、循环依赖与死代码检测

capsule 写入

打包可移植、可分享的上下文快照用于智能体交接

展开其余 9 个工具

entity 写入

管理工单、事故、发布、冲刺、OKR 和风险

project 写入

项目索引、范围与去索引管理

workspace 写入

工作区管理

skill 写入

可跨工具移植的指令与操作捆绑包

media 写入

索引并搜索图像、视频、音频和文档

vcs 只读

仓库链接管理

reminder 写入

提醒功能

integration 写入

第三方集成管理

help 只读

诊断与版本信息

使用场景

跨会话记住决策、计划和经验教训

语义搜索大型代码库

上下文压缩前自动保存关键状态

团队知识整合与带引用的问答

智能体之间的上下文交接

支持客户端

Claude Code

Cursor

Windsurf

Cline

Roo Code

VS Code + GitHub Copilot部分支持

Kilo Code部分支持

Codex部分支持

OpenCode部分支持

Aider部分支持

Antigravity部分支持

Claude Desktop部分支持

依据项目文档列出，未经本站实测。

详细介绍

ContextStream MCP 服务器为 Claude Code、Cursor、VS Code Copilot、Windsurf 等 MCP 兼容的 AI 编程助手提供持久化记忆、语义代码搜索和跨会话学习。它对代码库建立索引、记录决策与经验教训、映射依赖图，并整合 GitHub、Slack、Notion 团队知识。据官方基准，其在 LongMemEval-S（完整 500 实例、官方 GPT-4o 评审）上得分为 90.0%。

ContextStream MCP Server

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

工具能力 17

使用场景

支持客户端

详细介绍

同类可选方案