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 비디오 대본 검색

• 콘텐츠 유형을 지능적으로 감지하고 그에 따라 처리합니다.

설치 지침

1. https://claude.ai/download 에서 Claude Desktop을 설치하세요

2. Claude Desktop 구성 파일을 편집하세요.

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 다음 구성을 추가합니다.

지엑스피1

4. 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": {}
    }
  }
}

특허

MIT 라이센스