Reed

BETA. Reed는 지금도 공개적으로 사용할 수 있지만, 아직 1.0.0 이전 상태입니다. v1.0.0 태그가 붙기 전까지는 호환되지 않는 변경 사항이 있을 수 있습니다. 남은 작업은 아래 [v1.0.0 로드맵](#roadmap을 참조하세요.

그래프 기반 데이터 모델, 공개 REST API, 일급(first-class) MCP 서버를 갖춘 자체 호스팅 오픈소스 RSS 리더입니다.

Reed란 무엇인가?

Reed는 단일 사용자용 자체 호스팅 RSS 리더로, 단순함과 개발자 접근성을 위해 만들어졌습니다. 그래프 데이터베이스(Kuzu)를 사용해 피드, 기사, 저자, 토픽, 태그 사이의 관계를 모델링하고, 내장된 MCP 서버를 통해 AI 도구가 그래프를 탐색할 수 있게 합니다.

Related MCP server: mcp-obsidian

Reed를 만든 이유

제가 매일 읽는 루틴은 AI의 도움을 받는 세컨드 브레인(second brain)을 거치는데, RSS는 그 구조에 깔끔하게 들어맞지 않았습니다. 예전 사용하던 리더는 좋은 API 접근을 유료 요금제 뒤에 숨겨두었고, 그것조차 그 데이터 모델은 — 함께 세계의 다른 제품들 어디서든, 무료든 상업적든 — 아티클의 단조로운 목록였습니다. 어떤 것도 AI 클라이언트를 일급 소비자로 염두에 두고 만들지 않았기 때문에, 에이전트에게 "읽지 않은 항목" 같은 단순한 정보 이외의 것은 전달할 수 없었습니다.

Reed는 그래서 그 문제를 해결하고자 탄생했습니다. 여기서 피드, 기사, 저자, 토픽, 태그는 테이블의 행이 아닌 그래프의 노드와 엣지입니다. AI 클라이언트는 목록을 넘기는 것에 그치지 않고 하나의 기사, 그 기사의 토픽, 관련 토픽, 앞의 피드의 관련 기사로 이어지는 관계를 따라 그래프를 탐색할 수 있습니다. 이 프로젝트는 주말 프로토타입에서 시작해 지금은 매일 사용하는 도구로 자라났습니다.

현황

공개 베타, v1.0.0 이전 단계입니다. 마일스톤 M0 ~ M6은 완료되었습니다. 기반(foundation), 워킹 스켈레톤(walking skeleton), 사용 가능한 리더(usable reader), 마이그레이션 준비(migration-ready), 그래프 활성화(graph alive: 토픽 추출, 유사도 그래프), 전체 API와 통합(공유 시트, 내보내기/가져오기, 토픽 API), 그리고 stdio와 HTTP를 통해 AI 클라이언트에 전체 그래프를 노출하는 27개 도구의 MCP 서버까지 완성되었습니다. 현재 상태는 docs/roadmap/milestones.md에서 확인할 수 있으며, v1.0.0 전에 남은 작업은 아래 로드맵 섹션을 참조하세요.

설계 목표

• 간단하고 빠른 RSS 읽기 UI

• 완전한 공개 REST API (부차가 아니라 일류 등급)

• AI 클라이언트 통합과 그래프 탐색을 위한 MCP 서버

• 일반적으로 자체 호스팅 — SaaS와 클라우드 서비스 없음

• 운영 오버헤드 제로 — docker-compose.up한 번으로 실행

기술 구성

• Python — 모든 컴포넌트에 걸쳐 사용되는 응용 언어

• Kuzu — 일시(대입) 그래프 데이터베이스

• FastAPI — REST API 및 OpenAPI 문서

• FastMCP — MCP 서버

• Vue 3 + Vite — 웹 UI (세 영역의 읽기 화면, 키보드 중심)

• Docker Compose — 배포 및 배치

자체 호스팅

Reed는 아직 버전 릴리스로 배포되지 않고, GHCR의 Docker 이미지와 PyPI 패키지는 v1.0.0과 함께 배포됩니다. 그때까지는 소스에서 실행하세요:

git clone https://github.com/simonives/reed
cd reed
pip install -e .
reed serve

혹은 Docker 이미지를 로컬에서 빌드할 수 있습니다 (docker-compose.yml이 기대하는 태그와 맞추면 별도의 수정 없이 docker compose up으로 실행할 수 있습니다):

git clone https://github.com/simonives/reed
cd reed
docker build -t ghcr.io/simonives/reed:latest .
cp .env.example .env   # add your REED_API_KEY
docker compose up

어느 방식이든 시작 전에 실제 REED_API_KEY를 설정해야 합니다. 로컬 개발 설정은 .env.example와 CONTRIBUTING.md를 참조하세요.

v1.0.0 로드맵

추가.

• 웹사이트: GitHub Pages를 통해 제공될 라이브 프로젝트 사이트로, 퀵스타트와 설치 가이드를 담습니다.

• 배포 완성도: 릴리스 파이프라인은 구축되어 예비 검증(dry-run)을 마쳤지만, 아직 실제 v1.0.0 태그는 푸시되지 않았습니다.

• 공개 호스팅 인증 검토: 현재의 단일 정적 API 키 인증 모델은 같은 네트워크 안의 자체 호스팅을 전제로 두고 설계되었습니다. v1.0.0이 공개 호스팅(RAILWAY, Render, Fly.io)을 배포로 인정하기 위해서는, 그 모델을 별도로 검토하고 GitHub 이슈로 관리할 필요가 있습니다.

실시간 진행은 docs/roadmap/milestones.md와 저장소의 이슈(Issues)와 milestones를 통해 확인할 수 있습니다.

v1.0.0 이후 로드맵

초기 릴리스 이후 고려할 만한 계획은 이미 정리해 두었지만, 여기 만들어 주세요.

• 사용자가 직접 정의한 관심 목록(Watch list): 관심 토픽이나 설명을 많은형으로 저장해서 어떤 피드나 토픽 추출 경로에 따른지는 무관하게 해당 관심사에 들어맞는 새 항목이 올라올 때 표시해주는 기능.

• 저장된 그래프 탐색 뷰: 임시적인 탐색 도구가 아니라, 이름을 붙여 재사용 가능한 그래프 탐색 쿼리를 위한 방식.

• 저자와 공동저자 모델링: 저자를 단순 기사 메타로가 아닌, 저자만의 관계를 격을 가진 일급 그래프 개체로 다루는 것.

• 주기적 콘텐츠 발견: 사용자가 이미 구독하는 소스 밖의 새 콘텐츠도 발견을 막기 위한 옵트인(opt-in) 기능으로, 이미 흘러나온 콘텐츠의 한계를 넘어서는 것을 목적으로 합니다.

모든 항목의 근거가 된 전체 설계 결정 사항의 백로그는 저장소의 docs/roadmap/open-decisions.md에서 확인하세요.

라이선스

AGPL v3.0