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

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

Licencia

Licencia MIT

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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.

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.

Related MCP Servers

Roam Research
2b3pro
A
security
A
license
A
quality
Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
Last updated -
18
25
38
TypeScript
MIT License
MCP Unified Server
getfounded
-
security
A
license
-
quality
A modular server implementation for Claude AI assistants with integrated tools, enabling Claude to perform actions and access external resources like file systems, web searches, browser automation, financial data, and document generation.
Last updated -
66
Python
MIT License
PapersWithCode MCP
hbg
-
security
A
license
-
quality
A server that allows AI assistants to search for research papers, read their content, and access related code repositories through the PapersWithCode API.
Last updated -
9
Python
MIT License
MCP Linear App
zalab-inc
-
security
F
license
-
quality
A server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.
Last updated -
TypeScript

View all related MCP servers

Roam Research MCP Server