Roam Research

Conecta asistentes de IA a tu grafo de Roam Research para acceso e interacción con datos.

GitHub
8
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Roam Research

Un servidor de Model Context Protocol (MCP) que conecta Claude y otros asistentes de IA con tu grafo de Roam Research.

Qué hace esto

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

Por ejemplo, puedes decir:

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

Características

Creación de contenido

  • Crea nuevas páginas con contenido anidado y encabezados
  • Añade bloques a cualquier página con la jerarquía adecuada
  • Crea esquemas estructurados con anidamiento personalizable
  • Importa markdown con el anidamiento adecuado
  • Añade elementos de tareas pendientes con estado TODO automático
  • Actualiza contenido existente de forma individual o por lotes
  • Modifica el contenido de los bloques con transformaciones de patrones

Búsqueda y recuperación

  • Encuentra páginas y bloques por título, texto o etiquetas
  • Busca elementos TODO/HECHO con opciones de filtrado
  • Encuentra contenido modificado recientemente
  • Busca referencias de bloques y explora jerarquías de bloques
  • Busca por fechas de creación o modificación
  • Navega por las relaciones padre-hijo en los bloques
  • Ejecuta consultas Datalog personalizadas para necesidades avanzadas

Sistema de memoria

  • Almacena información para que Claude la recuerde entre conversaciones
  • Recupera recuerdos almacenados con opciones de filtrado y ordenación
  • Etiqueta recuerdos con categorías personalizadas
  • Accede tanto a recuerdos recientes como antiguos con recuperación flexible

Procesamiento de contenido de URL

  • Extrae e importa contenido de páginas web
  • Analiza y extrae texto de documentos PDF
  • Recupera transcripciones de videos de YouTube
  • Detecta inteligentemente el tipo de contenido y lo procesa en consecuencia

Instrucciones de configuración

  1. Instala Claude Desktop desde https://claude.ai/download
  2. Edita tu archivo de configuración de Claude Desktop:
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
      • Windows: %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 de API de Roam:
    • Ve a la configuración de tu grafo de Roam Research
      • Navega a "Tokens de API"
      • Haz clic en "+ Nuevo token de API"
      • Copia el token a tu configuración

Cómo usar

Una vez configurado, simplemente chatea con Claude y pídele que trabaje con tu grafo de Roam. Claude utilizará los comandos MCP apropiados en segundo plano.

Ejemplos de conversaciones:

Crear contenido:

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

Buscar contenido:

Tú: "Encuentra todos los bloques en mi grafo de Roam etiquetados con #ProjectIdeas que también mencionen aplicaciones móviles."

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

Usar 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 programar?"

Trabajar con contenido externo:

Tú: "Extrae los puntos principales de este PDF y añádelos a mi grafo de 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]]"
}

Soporte de Docker

Puedes ejecutar el servidor MCP de Roam en un contenedor Docker:

Construir la imagen

docker build -t roam-mcp .

Ejecutar el contenedor

Ejecuta con variables de entorno:

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

Usar con Claude Desktop

Configura Claude Desktop para usar el servidor contenerizado:

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

Licencia

Licencia MIT