Skip to main content
Glama
deenesjakoruzh
contextstream

ContextStream MCP Server

by contextstream
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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에게 뇌를 제공합니다.

AI는 단순히 내용을 기억하는 것을 넘어, 전체 코드베이스를 이해하고, 모든 대화에서 학습하며, 팀의 GitHub, Slack, Notion에서 지식을 가져와 정확한 순간에 필요한 컨텍스트를 제공합니다.

단 한 번의 설정으로 즉각적인 변화를 경험하세요.

설치 후 달라지는 점

이전

이후

AI가 파일을 하나씩 검색하여 토큰 낭비

**의미론적 검색(Semantic search)**으로 밀리초 단위로 코드의 의미를 파악

대화가 길어지면 컨텍스트 손실

스마트 압축으로 압축 전 중요한 정보 보존

도구마다 흩어진 팀 지식

GitHub, Slack, Notion의 지식을 통합 인텔리전스로 자동 결합

세션마다 반복되는 동일한 실수

학습 시스템을 통해 AI가 모든 실패로부터 학습

프로젝트 인식 없는 일반적인 응답

아키텍처, 의사결정, 패턴에 대한 깊이 있는 컨텍스트 제공

핵심 기능

의미론적 코드 인텔리전스

"인증 처리는 어디서 하지?"라고 물어보면 즉시 답을 얻을 수 있습니다. grep 체인도, 10개의 파일을 읽을 필요도 없습니다. AI가 개념적 수준에서 코드를 이해합니다.

SmartRouter 컨텍스트 전달

모든 메시지가 분석됩니다. 위험한 리팩토링인가요? 관련 학습 내용이 자동으로 나타납니다. 의사결정을 내리나요? AI가 이를 기록해야 함을 인지합니다. 요청하지 않아도 매번 올바른 컨텍스트가 제공됩니다.

팀 지식 융합

GitHub, Slack, Notion을 연결하세요. 몇 달 전의 논의 내용도 관련이 있을 때 나타납니다. PR 댓글에 묻혀 있던 아키텍처 결정 사항도 AI가 알고 있습니다.

코드 그래프 분석

"UserService에 의존하는 것은 무엇인가?" "이 함수를 변경하면 어떤 영향이 있는가?" AI가 전체 코드베이스의 연결 고리를 파악합니다.

컨텍스트 압박 인식

긴 대화인가요? ContextStream은 토큰 사용량을 추적하고, 중요한 상태를 자동 저장하며, 컨텍스트가 압축될 때 중요한 정보가 손실되지 않도록 보장합니다.

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은 이제 프로덕션 ContextStream 클라우드를 사용할 때 VS Code/Copilot을 이 호스팅 원격 서버로 기본 설정합니다. 로컬 런타임을 강제로 사용하려면 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)은 리디렉션 흐름을 위해 vscode.dev를 거치는 OAuth 인증을 사용합니다. 이는 vscode.dev가 차단된 환경(기업 네트워크, 지역 제한, CDN 수준 차단)에서는 실패할 수 있습니다.

해결 방법: 대신 API 키 인증과 함께 stdio 전송(Rust 바이너리 또는 Node.js)을 사용하세요:

{
  "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는 로컬 npm 기반 stdio 설정을 작성하는 대신 기본 OAuth 흐름을 사용할 수 있습니다.

위의 Rust 또는 Node 로컬 런타임 설정은 로컬 실행, 사용자 지정/자체 호스팅 엔드포인트 또는 호스팅 원격 흐름을 지원하지 않는 편집기 환경을 명시적으로 원할 때만 사용하세요.

링크

웹사이트: https://contextstream.io

문서: https://contextstream.io/docs

Install Server
A
license - permissive license
C
quality
A
maintenance

How are these scores calculated?

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.

Tools

View all tools

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