Roam Research MCP Server

by PhiloSolares
Verified

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.

Integrations

  • Supports importing nested markdown content with proper conversion into Roam Research's structure

  • Provides comprehensive access to Roam Research's API including creating pages and blocks, manipulating content, searching, retrieving information with custom queries, and an optional memory system for storing important information

  • Enables fetching transcripts from YouTube videos to incorporate into Roam Research pages

Roam Research MCP サーバー

Claude やその他の AI アシスタントを Roam Research グラフに接続する Model Context Protocol (MCP) サーバー。

これが何をするのか

このサーバーは、AIアシスタントとRoam Researchデータベース間の橋渡しとして機能します。セットアップ後は、ClaudeにRoamデータの操作を依頼するだけで、コーディングは一切不要です。

たとえば、次のように言うことができます。

  • 「これらの会議メモをRoamの今日の日次メモに追加する」
  • 「#ProjectIdeas のタグが付けられたブロックを Roam グラフで検索」
  • 「Roam に「プロジェクト計画」という新しいページを作成します」
  • 「今月作成したすべてのTODO項目を検索」

特徴

コンテンツ作成

  • ネストされたコンテンツと見出しを持つ新しいページを作成する
  • 適切な階層構造を持つ任意のページにブロックを追加します
  • カスタマイズ可能なネストで構造化されたアウトラインを作成する
  • 適切なネストでマークダウンをインポートする
  • 自動 TODO ステータスで ToDo 項目を追加する
  • 既存のコンテンツを個別または一括で更新する
  • パターン変換でブロックコンテンツを変更する

検索と取得

  • タイトル、テキスト、タグでページやブロックを検索
  • フィルタリングオプションを使用してTODO/DONE項目を検索する
  • 最近変更されたコンテンツを見つける
  • ブロック参照を検索し、ブロック階層を探索する
  • 作成日または変更日で検索
  • ブロック内の親子関係をナビゲートする
  • 高度なニーズに合わせてカスタム Datalog クエリを実行する

メモリシステム

  • 会話を通してクロードが覚えておくための情報を保存する
  • フィルタリングと並べ替えのオプションを使用して保存した思い出を思い出す
  • カスタムカテゴリで思い出にタグを付ける
  • 柔軟な検索機能で最近の記憶と古い記憶の両方にアクセス

URLコンテンツ処理

  • ウェブページからコンテンツを抽出してインポートする
  • PDF文書からテキストを解析して抽出する
  • YouTube動画のトランスクリプトを取得する
  • コンテンツの種類をインテリジェントに検出し、それに応じて処理します

セットアップ手順

  1. https://claude.ai/downloadから Claude Desktop をインストールします。
  2. Claude Desktop 構成ファイルを編集します。
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. 次の構成を追加します。
{ "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. Roam API トークンを取得します。
    • Roam Researchのグラフ設定に移動します
    • 「APIトークン」に移動します
    • 「+新しいAPIトークン」をクリックします
    • トークンを構成にコピーします

使い方

セットアップが完了したら、Claude とチャットして、Roam グラフを操作するように指示するだけです。Claude は適切な MCP コマンドをバックグラウンドで実行します。

会話の例:

コンテンツの作成:

あなた: 「クロード、私の Roam グラフに、モバイル アプリのアイデアのセクションを含む「プロジェクトのアイデア」という新しいページを作成してください。」

コンテンツの検索:

あなた: 「#ProjectIdeas のタグが付けられ、モバイル アプリにも言及している Roam グラフ内のすべてのブロックを検索します。」

あなた: 「今週作成したすべての TODO 項目を表示してください。」

メモリシステムの使用:

あなた:「JavaScript の学習には間隔をあけた反復学習を使いたいということを覚えておいてください。」

後ほど: あなた: 「プログラミングについてどのような学習テクニックについて話し合いましたか?」

外部コンテンツの操作:

あなた: 「この PDF から要点を抽出し、Roam グラフに追加します。」

あなた:「生産性に関するこの YouTube 動画のトランスクリプトを入手してください。」

詳細設定

デフォルトでは、思い出は#[[Memories]]タグで保存されます。別のタグを使用するには:

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

ライセンス

MITライセンス

-
security - not tested
F
license - not found
-
quality - not tested

Claude のような AI アシスタントが標準化されたインターフェースを介して Roam Research グラフと対話できるようにし、コンテンツの作成、検索、取得、およびオプションのメモリ管理のための包括的なツールを提供するサーバー。

  1. What This Does
    1. Features
      1. Content Creation
      2. Search and Retrieval
      3. Memory System
      4. URL Content Processing
    2. Setup Instructions
      1. How to Use
        1. Advanced Configuration
          1. License
            ID: 7g1y9zke2l