Roam Research

Servidor MCP 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 programaçã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 'Project Planning'"
• "Encontre todos os itens TODO que criei este mês"

Recursos

Criação de Conteúdo

• Criar novas páginas com conteúdo aninhado e cabeçalhos
• Adicionar blocos a qualquer página com hierarquia adequada
• Criar esboços estruturados com aninhamento personalizável
• Importar markdown com aninhamento adequado
• Adicionar itens de tarefa com status TODO automático
• Atualizar conteúdo existente individualmente ou em lote
• Modificar conteúdo de blocos com transformações de padrão

Pesquisa e Recuperação

• Encontrar páginas e blocos por título, texto ou tags
• Pesquisar itens TODO/DONE com opções de filtro
• Encontrar conteúdo modificado recentemente
• Pesquisar referências de blocos e explorar hierarquias de blocos
• Pesquisar por datas de criação ou modificação
• Navegar por relacionamentos pai-filho em blocos
• Executar consultas Datalog personalizadas para necessidades avançadas

Sistema de Memória

• Armazenar informações para o Claude lembrar entre conversas
• Recuperar memórias armazenadas com opções de filtro e ordenação
• Marcar memórias com categorias personalizadas
• Acessar memórias recentes e antigas com recuperação flexível

Processamento de Conteúdo de URL

• Extrair e importar conteúdo de páginas da web
• Analisar e extrair texto de documentos PDF
• Recuperar transcrições de vídeos do YouTube
• Detectar inteligentemente o tipo de conteúdo e processar de acordo

Instruções de Configuração

1. Instale o Claude Desktop a partir de https://claude.ai/download
2. Edite o 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>"
      }
    }
  }
}

4. Obtenha seu token da API do Roam:
   • Vá para as configurações do seu grafo do 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 que ele trabalhe 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 'Project Ideas' 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": "your-token",
  "ROAM_GRAPH_NAME": "your-graph",
  "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="your_api_token" \
  -e ROAM_GRAPH_NAME="your_graph_name" \
  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=your_token",
               "-e", "ROAM_GRAPH_NAME=your_graph",
               "roam-mcp"],
      "env": {}
    }
  }
}

Licença

Licença MIT