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

Related MCP server: BuildAutomata Memory MCP Server

Это не просто память. Это интеллект.

Другие инструменты дают вашему ИИ блокнот. ContextStream дает ему мозг.

Ваш ИИ не просто запоминает вещи — он понимает всю вашу кодовую базу, учится на каждом диалоге, извлекает знания из GitHub, Slack и Notion вашей команды и предоставляет именно тот контекст, который нужен, в нужный момент.

Одна настройка. Мгновенное преображение.

Что меняется после установки

Возможности под капотом

Семантический анализ кода

Спросите «где у нас обрабатывается аутентификация?» и получите ответ мгновенно. Никаких цепочек grep. Никакого чтения 10 файлов. Ваш ИИ понимает ваш код на концептуальном уровне.

Доставка контекста SmartRouter

Каждое сообщение анализируется. Рискованный рефакторинг? Автоматически всплывают соответствующие уроки. Принимаете решение? Ваш ИИ знает, что его нужно зафиксировать. Правильный контекст в любое время, без ваших просьб.

Объединение знаний команды

Подключите GitHub, Slack и Notion. Обсуждения месячной давности? Всплывут, когда станут актуальны. То архитектурное решение, зарытое в комментарии к PR? Ваш ИИ знает о нем.

Анализ графа кода

«Что зависит от UserService?» «Каково влияние изменения этой функции?» Ваш ИИ видит связи во всей вашей кодовой базе.

Учет давления на контекст

Длинный диалог? ContextStream отслеживает использование токенов, автоматически сохраняет критическое состояние и гарантирует, что ничего важного не будет потеряно при сжатии контекста.

Инструменты, которые получает ваш ИИ

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

Ваш ИИ использует их автоматически. Вы просто пишете код.

Глобальное резервное рабочее пространство (несопоставленные папки)

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
    }
  }
}

Для локального варианта экспортируйте CONTEXTSTREAM_API_KEY перед запуском OpenCode.

Расположение: ./opencode.json • ~/.config/opencode/opencode.json

Для GitHub Copilot в VS Code самый простой путь — это размещенный удаленный MCP со встроенным OAuth. Установка через Marketplace должна автоматически записывать определение этого удаленного сервера.

Размещенный удаленный 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.

Для self-hosted или нестандартных 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 в качестве команды.

• Принудительная локальная настройка VS Code/Copilot: CONTEXTSTREAM_VSCODE_MCP_MODE=local.

• Принудительная удаленная настройка VS Code/Copilot: CONTEXTSTREAM_VSCODE_MCP_MODE=remote.

• Используйте mcpServers в конфигурации Copilot CLI и servers в конфигурации VS Code.

Быстрое устранение неполадок

• Удалите дублирующиеся записи ContextStream в областях конфигурации Workspace/User.

• Проверьте, установлены ли 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.

Примечание к Marketplace

Запись в Marketplace MCP теперь указывает на размещенный удаленный MCP по адресу https://mcp.contextstream.io/mcp?default_context_mode=fast, чтобы VS Code мог использовать нативный поток OAuth вместо записи локальной конфигурации stdio на основе npm.

Используйте локальные конфигурации Rust или Node, приведенные выше, только если вам явно требуется локальное выполнение, пользовательские/self-hosted эндпоинты или среды редакторов, которые не поддерживают поток удаленного размещения.

Ссылки

Веб-сайт: https://contextstream.io

Документация: https://contextstream.io/docs