Roam Research

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

GitHub
8

Documentación

Roam Research MCP Server

Un servidor de Model Context Protocol (MCP) que conecta a 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 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 'Project Planning'"
  • "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 tarea con estado TODO automático
  • Actualiza contenido existente individualmente o en lotes
  • Modifica el contenido de bloques con transformaciones de patrones

Búsqueda y recuperación

  • Encuentra páginas y bloques por título, texto o etiquetas
  • Busca elementos TODO/DONE 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 relaciones padre-hijo en bloques
  • Ejecuta consultas Datalog personalizadas para necesidades avanzadas

Sistema de memoria

  • Almacena información para que Claude la recuerde entre conversaciones
  • Recupera memorias almacenadas con opciones de filtrado y ordenación
  • Etiqueta memorias con categorías personalizadas
  • Accede a memorias recientes y antiguas con recuperación flexible

Procesamiento de contenido 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 procésalo 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 "API tokens"
    • Haz clic en "+ New API Token"
    • Copia el token en tu configuración

Cómo usar

Una vez configurado, simplemente chatea con Claude y pídele que trabaje con tu grafo de Roam. 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 grafo de Roam llamada 'Project Ideas' con una sección para ideas de aplicaciones móviles."

Búsqueda de 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."

Uso del sistema de memoria:

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

Más tarde: Tú: "¿Qué técnicas de aprendizaje hemos discutido para programar?"

Trabajo 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, las memorias 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 para Docker

Puedes ejecutar el servidor Roam MCP en un contenedor Docker:

Construyendo la imagen

docker build -t roam-mcp .

Ejecutando 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

Uso con Claude Desktop

Configura Claude Desktop para usar el servidor en contenedor:

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

MIT License