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"

Related MCP server: MCP Unified Server

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

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

Soporte de Docker

Puede ejecutar el servidor Roam MCP en un contenedor Docker:

Construyendo la imagen

docker build -t roam-mcp .

Ejecución del contenedor

Ejecutar 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

Configurar Claude Desktop para utilizar el servidor en contenedores:

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