Skip to main content
Glama
contextstream

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 | bash
irm 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_URLCONTEXTSTREAM_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

文档: https://contextstream.io/docs


Install Server
A
license - permissive license
C
quality
A
maintenance

Maintenance

Maintainers
2dResponse time
1dRelease cycle
46Releases (12mo)
Issues opened vs closed

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