Claude Code 및 기타 MCP 클라이언트가 org-roam 지식 베이스와 상호 작용하는 모델 Context Protocol (MCP) 서버.

특징

• 더 동작: 검색 및 검색 org-roam 노드, backlinks 및 관계를 탐구 -Write Operations: 새로운 노트 만들기, 기존 콘텐츠를 업데이트, 노드 사이의 링크를 추가
• ** 완전 통합**: Respects org-roam의 파일 구조, UUID 시스템 및 컨벤션
• ** 자동 탐지 **: 자동으로 org-roam 데이터베이스 및 디렉토리를 찾습니다. -Fast Search: 효율적인 쿼리를 위한 org-roam의 SQLite 데이터베이스 활용 -Robust 오류 처리: 포괄적인 입력 검증 및 descriptive 오류 메시지
• **Path 정상화 **: 저장된/unquoted 파일 경로 및 노드 ID를 일관적으로 처리
• **Database 동기화 **: 파일 작업 후 자동 새로 고침

최근 개선

v0.2.0 - 향상된 신뢰성 (최근)

• ** 수정 파일 경로 처리 ** : org-roam 데이터베이스에서 인용 된 파일 경로와 해결 -** Improve 향상된 Node ID 지원**: 이제 모두 인용되지 않은 노드 ID 형식을 완벽하게 처리

Org-roam MCP Server

A Model Context Protocol (MCP) server that enables Claude Code and other MCP clients to interact with your org-roam knowledge base.

Features

• Read Operations: Search and retrieve org-roam nodes, explore backlinks and relationships
• Write Operations: Create new notes, update existing content, add links between nodes
• Full Integration: Respects org-roam’s file structure, UUID system, and conventions
• Auto-Detection: Automatically finds your org-roam database and directory
• Fast Search: Leverages org-roam’s SQLite database for efficient queries
• Robust Error Handling: Comprehensive input validation and descriptive error messages
• Path Normalization: Handles quoted/unquoted file paths and node IDs consistently
• Database Synchronization: Automatic refresh after file operations for immediate updates

Recent Improvements

v0.2.0 - Enhanced Reliability (Latest)

• 🔧 Fixed File Path Handling: Resolved issues with quoted file paths from the org-roam database
• 🆔 Improved Node ID Support: Now handles both quoted and unquoted node ID formats seamlessly
• 🔄 Enhanced Search Synchronization: Database automatically refreshes after create/update operations
• ✅ Better Error Handling: Added comprehensive input validation with clear error messages
• 🧹 Path Cleaning: Automatic normalization of file paths with quote removal
• 📝 Improved Logging: Better error reporting and debugging information

Installation

# Using uvx (recommended)
uvx org-roam-mcp

# Or with pip in a virtual environment
pip install org-roam-mcp

Configuration

Auto-Detection

The server automatically detects your org-roam setup by looking for:

Database locations:

• ~/.emacs.d/org-roam.db
• ~/org-roam.db
• ~/.config/emacs/org-roam.db
• ~/Documents/org-roam/org-roam.db

Directory locations:

• ~/org-roam/
• ~/Documents/org-roam/
• ~/Dropbox/org-roam/
• ~/Notes/

Manual Configuration

Override auto-detection with environment variables:

export ORG_ROAM_DB_PATH="/path/to/your/org-roam.db"
export ORG_ROAM_DIR="/path/to/your/org-roam-directory"
export ORG_ROAM_MAX_SEARCH_RESULTS=100  # Default: 50

Usage with Claude Code

Add to your Claude Code MCP configuration (~/.claude_code/mcp.json):

{
  "mcpServers": {
    "org-roam": {
      "command": "uvx",
      "args": ["org-roam-mcp"]
    }
  }
}

Or for local development:

{
  "mcpServers": {
    "org-roam": {
      "command": "python",
      "args": ["-m", "org_roam_mcp.server"],
      "env": {
        "ORG_ROAM_DB_PATH": "/path/to/your/org-roam.db",
        "ORG_ROAM_DIR": "/path/to/your/org-roam"
      }
    }
  }
}

Available Tools

Search and Discovery

• search_nodes: Search for nodes by title, tags, or aliases
• get_node: Get detailed information about a specific node
• get_backlinks: Find all nodes that link to a specific node