Roam Research MCP Server

by PhiloSolares
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Supports importing nested markdown content with proper conversion into Roam Research's structure

  • Provides comprehensive access to Roam Research's API including creating pages and blocks, manipulating content, searching, retrieving information with custom queries, and an optional memory system for storing important information

  • Enables fetching transcripts from YouTube videos to incorporate into Roam Research pages

Servidor MCP de Roam Research

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta a Claude y otros asistentes de IA a su gráfico de Roam Research.

¿Qué hace esto?

Este servidor actúa como puente entre los asistentes de IA y tu base de datos de Roam Research. Tras la configuración, puedes pedirle a Claude que trabaje con tus datos de Roam, sin necesidad de programar.

Por ejemplo, puedes decir:

  • Añade estas notas de reunión a la nota diaria de hoy en Roam.
  • Busca en mi gráfico de Roam los bloques etiquetados con #ProjectIdeas.
  • Crea una nueva página en Roam llamada "Planificación del proyecto".
  • "Encuentra todos los elementos TODO que creé este mes"

Características

Creación de contenido

  • Crear nuevas páginas con contenido y encabezados anidados
  • Agregue bloques a cualquier página con la jerarquía adecuada
  • Cree esquemas estructurados con anidamiento personalizable
  • Importar Markdown con anidamiento adecuado
  • Agregar elementos de tareas pendientes con estado TODO automático
  • Actualizar el contenido existente individualmente o en lotes
  • Modificar el contenido del bloque con transformaciones de patrones

Búsqueda y recuperación

  • Busque páginas y bloques por título, texto o etiquetas
  • Busque elementos TODO/HECHO con opciones de filtrado
  • Encuentra contenido modificado recientemente
  • Busque referencias de bloques y explore jerarquías de bloques
  • Buscar por fechas de creación o modificación
  • Navegar por las relaciones padre-hijo en bloques
  • Ejecute consultas de registro de datos personalizadas para necesidades avanzadas

Sistema de memoria

  • Almacenar información para que Claude la recuerde en las conversaciones
  • Recupere recuerdos almacenados con opciones de filtrado y clasificación
  • Etiqueta recuerdos con categorías personalizadas
  • Acceda a recuerdos recientes y antiguos con recuperación flexible

Procesamiento de contenido de URL

  • Extraer e importar contenido de páginas web
  • Analizar y extraer texto de documentos PDF
  • Recuperar transcripciones de vídeos de YouTube
  • Detecta de forma inteligente el tipo de contenido y trátalo en consecuencia

Instrucciones de configuración

  1. Instale Claude Desktop desde https://claude.ai/download
  2. Edite su archivo de configuración de Claude Desktop:
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
  3. Añade esta configuración:
{ "mcpServers": { "roam-helper": { "command": "uvx", "args": ["git+https://github.com/PhiloSolares/roam-mcp.git"], "env": { "ROAM_API_TOKEN": "<your_roam_api_token>", "ROAM_GRAPH_NAME": "<your_roam_graph_name>" } } } }
  1. Obtén tu token API de Roam:
    • Ve a la configuración de gráficos de Roam Research
    • Vaya a "Tokens de API".
    • Haga clic en "+ Nuevo token de API".
    • Copia el token a tu configuración

Cómo utilizar

Una vez configurado, simplemente chatea con Claude y pídele que trabaje con tu gráfico de Roaming. Claude usará los comandos MCP apropiados en segundo plano.

Ejemplos de conversaciones:

Creación de contenido:

Tú: "Claude, por favor crea una nueva página en mi gráfico Roam llamada 'Ideas de proyectos' con una sección para ideas de aplicaciones móviles".

Buscando contenido:

Tú: "Encuentra todos los bloques en mi gráfico Roam etiquetados con #ProjectIdeas que también mencionan aplicaciones móviles".

Tú: "Muéstrame todos los elementos TODO que creé esta semana".

Usando el sistema de memoria:

Tú: "Recuerda que quiero usar la repetición espaciada para aprender JavaScript".

Más tarde: Tú: "¿Qué técnicas de aprendizaje hemos discutido para la programación?"

Trabajar con contenido externo:

Tú: "Extrae los puntos principales de este PDF y agrégalos a mi gráfico Roam".

Tú: "Obtén la transcripción de este video de YouTube sobre productividad".

Configuración avanzada

Por defecto, los recuerdos se almacenan con la etiqueta #[[Memories]] . Para usar una etiqueta diferente:

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

Licencia

Licencia MIT

-
security - not tested
F
license - not found
-
quality - not tested

Un servidor que permite a los asistentes de IA como Claude interactuar con los gráficos de Roam Research a través de una interfaz estandarizada, proporcionando herramientas integrales para la creación de contenido, búsqueda, recuperación y gestión de memoria opcional.

  1. What This Does
    1. Features
      1. Content Creation
      2. Search and Retrieval
      3. Memory System
      4. URL Content Processing
    2. Setup Instructions
      1. How to Use
        1. Advanced Configuration
          1. License
            ID: 7g1y9zke2l