Burn — 개인 지식 베이스 MCP 서버

npm version License: MIT

AI가 액세스할 수 있는 지식 베이스로서의 읽기 데이터. Claude, Cursor, Windsurf 및 모든 MCP 호환 에이전트를 위한 26개의 도구입니다.

작동 방식

Burn은 24시간 타이머를 사용하여 읽기 자료를 분류합니다:

Flame(불꽃) → 새로운 링크. 24시간 내에 읽지 않으면 소멸됩니다.
Spark(불꽃) → 읽은 자료. 30일간 유지됩니다.
Vault(보관소) → 영구 보관. 직접 큐레이션한 지식입니다.
Ash(재) → 만료된 자료. 기한이 지난 항목입니다.

이 MCP 서버를 사용하면 AI 에이전트가 저장한 모든 항목을 검색, 분류, 정리 및 분석할 수 있습니다.

빠른 시작

1. 토큰 받기

iOS용 Burn을 다운로드하거나 Burn 웹사이트 → 설정 → MCP 서버 → 액세스 토큰 복사를 수행하세요.

2. 연결 모드 선택

2a. 로컬 — stdio (Claude Desktop / Claude Code CLI / Cursor / Windsurf)

{
  "mcpServers": {
    "burn": {
      "command": "npx",
      "args": ["burn-mcp-server"],
      "env": {
        "BURN_MCP_TOKEN": "<your-token>"
      }
    }
  }
}

2b. 원격 — HTTPS (claude.ai 커넥터 / Claude Code 루틴 / 모든 클라우드 MCP 클라이언트)

엔드포인트:

https://burn-mcp-server.vercel.app/api/mcp

인증: Authorization: Bearer <BURN_MCP_TOKEN> 헤더.

claude.ai 커넥터의 경우 (설정 → 커넥터 → 사용자 지정 MCP 추가):

URL: https://burn-mcp-server.vercel.app/api/mcp
헤더: Authorization: Bearer <본인의 BURN_MCP_TOKEN>

Claude Code 루틴의 경우: 설정 → 커넥터에서 전역적으로 연결하면 루틴에 자동으로 포함됩니다.

직접 curl 테스트:

curl -X POST https://burn-mcp-server.vercel.app/api/mcp \
  -H "Authorization: Bearer $BURN_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

전송: 상태 비저장 StreamableHTTP, JSON 응답 모드. 동일한 26개의 도구, 동일한 토큰, 설치 불필요.

3. 질문 시작하기

"시스템 설계에 대해 저장한 내용이 뭐야?"
"내 Flame을 분류해줘 — 무엇을 보관해야 할까?"
"내 AI 북마크로 컬렉션을 만들어줘"

도구 (26개)

검색 및 읽기

도구	기능
`search_vault`	키워드로 영구 북마크 검색
`list_vault`	카테고리별 보관소 북마크 나열
`list_sparks`	최근 읽은 북마크 나열 (30일 기간)
`search_sparks`	키워드로 Spark 검색
`list_flame`	받은 편지함 나열 — 곧 소멸될 항목
`get_flame_detail`	Flame 북마크의 상세 정보
`get_bookmark`	ID로 북마크 가져오기
`get_article_content`	전체 기사 내용 및 분석 가져오기
`fetch_content`	URL에서 콘텐츠 가져오기 (X, Reddit, YouTube, WeChat)
`list_categories`	개수가 포함된 모든 보관소 카테고리
`get_collections`	모든 컬렉션 나열
`get_collection_overview`	AI 개요가 포함된 컬렉션 상세 정보

분류 (에이전트가 필터 역할)

도구	기능
`move_flame_to_spark`	보관 — 읽을 가치가 있음. 선택적 통찰력 추가.
`move_flame_to_ash`	소멸 — 삭제. 선택적 이유 추가.
`move_spark_to_vault`	승격 — 영구 보관. 선택적 카테고리 추가.
`move_spark_to_ash`	보관 가치 없음.
`batch_triage_flame`	한 번에 최대 20개까지 분류.

컬렉션 (에이전트가 큐레이터 역할)

도구	기능
`create_collection`	초기 북마크가 포함된 주제 번들 생성
`add_to_collection`	북마크 추가 (중복 제거)
`remove_from_collection`	북마크 제거
`update_collection_overview`	AI 개요 작성 (주제, 종합, 누락된 정보)

분석 (에이전트가 분석가 역할)

도구	기능
`write_bookmark_analysis`	북마크에 구조화된 분석 내용 작성

자동 피드 (에이전트가 스카우트 역할)

도구	기능
`add_watched_source`	X 사용자, RSS 피드 또는 YouTube 채널 구독. 새 게시물이 Flame으로 자동 유입됩니다.
`list_watched_sources`	활성화된 모든 구독 소스 나열
`remove_watched_source`	소스 구독 중단
`scrape_watched_sources`	요청 시 구독 소스에서 새 콘텐츠 가져오기

리소스

URI	콘텐츠
`burn://vault/bookmarks`	모든 보관소 북마크 (JSON)
`burn://vault/categories`	카테고리 목록 (JSON)

사용 사례

개인 지식 관리 — 에이전트가 읽기 기록을 검색하여 질문에 답하고, 패턴을 찾으며, 잊혀진 정보를 찾아냅니다.

연구 워크플로우 — 탐구 중인 주제에 대한 컬렉션을 만듭니다. 에이전트가 소스를 종합하여 개요를 작성합니다.

읽기 분류 — 에이전트가 Flame 받은 편지함을 검토하고, 내용을 읽고, 관심사에 따라 보관할 가치가 있는 항목을 결정합니다.

도구 간 지능형 연동 — Claude Code, Cursor 또는 Windsurf와 함께 사용하세요. 북마크가 코딩, 글쓰기 및 사고를 위한 컨텍스트가 됩니다.

환경 변수

변수	필수	설명
`BURN_MCP_TOKEN`	예*	장기 MCP 토큰 (권장)
`BURN_SUPABASE_TOKEN`	예*	레거시 JWT 토큰 (여전히 지원됨)
`BURN_API_URL`	아니요	사용자 지정 API URL (기본값: 프로덕션)

*BURN_MCP_TOKEN 또는 BURN_SUPABASE_TOKEN 중 하나가 필요합니다.

보안

데이터에만 범위가 지정된 토큰 (행 수준 보안)
상태 흐름 강제 적용: Flame → Spark → Vault, 또는 → Ash
속도 제한: 세션당 분당 30회 호출
토큰은 30일 후 만료

링크

앱: burn451.cloud
iOS 앱: App Store
npm: burn-mcp-server
Chrome 확장 프로그램: Chrome 웹 스토어에서 "Bookmark Autopsy" 검색

라이선스

MIT

burn-mcp-server