Roam Research MCP 서버

Claude와 다른 AI 도우미를 Roam Research 그래프에 연결하는 MCP(Model Context Protocol) 서버입니다.

이것이 하는 일

이 서버는 AI 비서와 Roam Research 데이터베이스를 연결하는 다리 역할을 합니다. 설정 후에는 코딩 없이 Claude에게 Roam 데이터 작업을 요청하기만 하면 됩니다.

예를 들어, 다음과 같이 말할 수 있습니다.

"오늘의 회의 노트를 Roam의 일일 노트에 추가하세요"
"#ProjectIdeas" 태그가 있는 블록을 Roam 그래프에서 검색하세요.
"Roam에 '프로젝트 계획'이라는 새 페이지를 만드세요."
"이번 달에 내가 만든 모든 TODO 항목 찾기"

Related MCP server: MCP Unified Server

특징

콘텐츠 생성

중첩된 콘텐츠와 제목으로 새 페이지를 만듭니다.
적절한 계층 구조를 갖춘 모든 페이지에 블록을 추가합니다.
사용자 정의 가능한 중첩을 통해 구조화된 개요를 만듭니다.
적절한 중첩을 통한 마크다운 가져오기
자동 TODO 상태로 할 일 항목 추가
기존 콘텐츠를 개별적으로 또는 일괄적으로 업데이트합니다.
패턴 변환을 사용하여 블록 콘텐츠 수정

검색 및 검색

제목, 텍스트 또는 태그로 페이지 및 블록 찾기
필터링 옵션을 사용하여 TODO/DONE 항목 검색
최근 수정된 콘텐츠 찾기
블록 참조 검색 및 블록 계층 구조 탐색
생성 또는 수정 날짜로 검색
블록으로 부모-자식 관계 탐색
고급 요구 사항에 맞게 사용자 정의 Datalog 쿼리 실행

메모리 시스템

대화 전반에 걸쳐 Claude가 기억할 수 있는 정보를 저장합니다.
필터링 및 정렬 옵션을 사용하여 저장된 메모리를 불러오세요
사용자 정의 카테고리로 추억에 태그를 지정하세요
유연한 검색을 통해 최근 및 이전 메모리에 모두 액세스

URL 콘텐츠 처리

웹 페이지에서 콘텐츠 추출 및 가져오기
PDF 문서에서 텍스트 구문 분석 및 추출
YouTube 비디오 대본 검색
콘텐츠 유형을 지능적으로 감지하고 그에 따라 처리합니다.

설치 지침

https://claude.ai/download 에서 Claude Desktop을 설치하세요
Claude Desktop 구성 파일을 편집하세요.
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
다음 구성을 추가합니다.

지엑스피1

Roam API 토큰을 받으세요:
- Roam Research 그래프 설정으로 이동하세요
- "API 토큰"으로 이동하세요
- "+ 새 API 토큰"을 클릭하세요
- 토큰을 구성에 복사하세요

사용 방법

설정이 완료되면 Claude와 채팅하여 Roam 그래프와 연동해 달라고 요청하세요. Claude가 백그라운드에서 적절한 MCP 명령을 사용합니다.

대화 예시:

콘텐츠 생성:

당신: "클로드, Roam 그래프에 '프로젝트 아이디어'라는 새 페이지를 만들어 주세요. 모바일 앱 아이디어 섹션도 만들어 주세요."

콘텐츠 검색:

당신: "#ProjectIdeas" 태그가 붙고 모바일 앱을 언급하는 Roam 그래프의 모든 블록을 찾으세요.
당신: "이번 주에 내가 만든 모든 TODO 항목을 보여주세요."

메모리 시스템 사용:

당신: "JavaScript를 배우려면 분산 반복을 사용해야 한다는 걸 기억하세요."
나중에: 당신: "우리는 프로그래밍을 위해 어떤 학습 기법을 논의했나요?"

외부 콘텐츠 작업:

당신: "이 PDF에서 주요 포인트를 추출하여 Roam 그래프에 추가하세요."
당신: "생산성에 대한 이 YouTube 동영상의 대본을 받아보세요."

고급 구성

기본적으로 메모리는 #[[Memories]] 태그로 저장됩니다. 다른 태그를 사용하려면:

"env": { "ROAM_API_TOKEN": "your-token", "ROAM_GRAPH_NAME": "your-graph", "MEMORIES_TAG": "#[[Claude/Memories]]" }

도커 지원

Docker 컨테이너에서 Roam MCP 서버를 실행할 수 있습니다.

이미지 구축

docker build -t roam-mcp .

컨테이너 실행

환경 변수로 실행:

docker run -p 3000:3000 \ -e ROAM_API_TOKEN="your_api_token" \ -e ROAM_GRAPH_NAME="your_graph_name" \ roam-mcp

Claude Desktop과 함께 사용

컨테이너화된 서버를 사용하도록 Claude Desktop을 구성합니다.

{ "mcpServers": { "roam-helper": { "command": "docker", "args": ["run", "--rm", "-p", "3000:3000", "-e", "ROAM_API_TOKEN=your_token", "-e", "ROAM_GRAPH_NAME=your_graph", "roam-mcp"], "env": {} } } }