Roam Research

Conecta assistentes de IA ao seu grafo do Roam Research para acesso e interação com dados.

GitHub
8
Experimente este MCPPatrocinado

Documentação

Servidor MCP do Roam Research

Um servidor Model Context Protocol (MCP) que conecta o Claude e outros assistentes de IA ao seu grafo do Roam Research.

O Que Isso Faz

Este servidor atua como uma ponte entre assistentes de IA e seu banco de dados do Roam Research. Após a configuração, você pode simplesmente pedir ao Claude para trabalhar com seus dados do Roam - sem necessidade de codificação.

Por exemplo, você pode dizer:

  • "Adicione estas notas de reunião à nota diária de hoje no Roam"
  • "Pesquise no meu grafo do Roam por blocos marcados com #ProjectIdeas"
  • "Crie uma nova página no Roam chamada 'Planejamento de Projetos'"
  • "Encontre todos os itens TODO que criei este mês"

Recursos

Criação de Conteúdo

  • Crie novas páginas com conteúdo aninhado e cabeçalhos
  • Adicione blocos a qualquer página com hierarquia adequada
  • Crie esboços estruturados com aninhamento personalizável
  • Importe markdown com aninhamento adequado
  • Adicione itens de tarefas com status TODO automático
  • Atualize conteúdo existente individualmente ou em lote
  • Modifique o conteúdo dos blocos com transformações de padrão

Pesquisa e Recuperação

  • Encontre páginas e blocos por título, texto ou tags
  • Pesquise itens TODO/DONE com opções de filtro
  • Encontre conteúdo modificado recentemente
  • Pesquise referências de blocos e explore hierarquias de blocos
  • Pesquise por datas de criação ou modificação
  • Navegue pelas relações pai-filho nos blocos
  • Execute consultas Datalog personalizadas para necessidades avançadas

Sistema de Memória

  • Armazene informações para o Claude lembrar entre conversas
  • Recupere memórias armazenadas com opções de filtro e ordenação
  • Marque memórias com categorias personalizadas
  • Acesse memórias recentes e antigas com recuperação flexível

Processamento de Conteúdo de URL

  • Extraia e importe conteúdo de páginas da web
  • Analise e extraia texto de documentos PDF
  • Recupere transcrições de vídeos do YouTube
  • Detecte inteligentemente o tipo de conteúdo e processe de acordo

Instruções de Configuração

  1. Instale o Claude Desktop a partir de https://claude.ai/download
  2. Edite seu arquivo de configuração do Claude Desktop:
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. Adicione esta configuração:

{ "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. Obtenha seu token da API do Roam:
    • Vá para as configurações do seu grafo no Roam Research
    • Navegue até "API tokens"
    • Clique em "+ New API Token"
    • Copie o token para sua configuração

Como Usar

Após a configuração, basta conversar com o Claude e pedir para ele trabalhar com seu grafo do Roam. O Claude usará os comandos MCP apropriados nos bastidores.

Exemplos de conversas:

Criando Conteúdo:

Você: "Claude, por favor crie uma nova página no meu grafo do Roam chamada 'Ideias de Projetos' com uma seção para ideias de aplicativos móveis."

Pesquisando Conteúdo:

Você: "Encontre todos os blocos no meu grafo do Roam marcados com #ProjectIdeas que também mencionem aplicativos móveis."

Você: "Mostre-me todos os itens TODO que criei esta semana."

Usando o Sistema de Memória:

Você: "Lembre-se de que quero usar repetição espaçada para aprender JavaScript."

Mais tarde: Você: "Quais técnicas de aprendizado discutimos para programação?"

Trabalhando com Conteúdo Externo:

Você: "Extraia os pontos principais deste PDF e adicione-os ao meu grafo do Roam."

Você: "Obtenha a transcrição deste vídeo do YouTube sobre produtividade."

Configuração Avançada

Por padrão, as memórias são armazenadas com a tag #[[Memories]]. Para usar uma tag diferente:

"env": { "ROAM_API_TOKEN": "seu-token", "ROAM_GRAPH_NAME": "seu-grafo", "MEMORIES_TAG": "#[[Claude/Memories]]" }

Suporte a Docker

Você pode executar o servidor MCP do Roam em um contêiner Docker:

Construindo a Imagem

docker build -t roam-mcp .

Executando o Contêiner

Execute com variáveis de ambiente:

docker run -p 3000:3000
-e ROAM_API_TOKEN="seu_token_api"
-e ROAM_GRAPH_NAME="seu_nome_grafo"
roam-mcp

Usando com o Claude Desktop

Configure o Claude Desktop para usar o servidor em contêiner:

{ "mcpServers": { "roam-helper": { "command": "docker", "args": ["run", "--rm", "-p", "3000:3000", "-e", "ROAM_API_TOKEN=seu_token", "-e", "ROAM_GRAPH_NAME=seu_grafo", "roam-mcp"], "env": {} } } }

Licença

Licença MIT