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

Instale Claude Desktop desde https://claude.ai/download
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
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>" } } } }

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