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

漫游研究 MCP 服务器

模型上下文协议 (MCP) 服务器将 Claude 和其他 AI 助手连接到您的 Roam Research 图。

它的作用

该服务器充当 AI 助手和您的 Roam Research 数据库之间的桥梁。设置完成后，您可以直接让 Claude 处理您的 Roam 数据，无需任何编程。

例如，你可以说：

“将这些会议记录添加到 Roam 中的今日每日记录中”
“在我的漫游图中搜索带有#ProjectIdeas标签的区块”
“在 Roam 中创建一个名为‘项目规划’的新页面”
“查找我本月创建的所有 TODO 项”

特征

内容创作

创建具有嵌套内容和标题的新页面
将块添加到具有适当层次结构的任何页面
使用可自定义的嵌套创建结构化轮廓
使用适当的嵌套导入 markdown
添加具有自动 TODO 状态的待办事项
单独或批量更新现有内容
使用图案变换修改块内容

搜索和检索

通过标题、文本或标签查找页面和区块
使用过滤选项搜索 TODO/DONE 项目
查找最近修改的内容
搜索块引用并探索块层次结构
按创建或修改日期搜索
在块中导航父子关系
执行自定义数据日志查询以满足高级需求

记忆系统

存储克劳德在对话中记住的信息
使用过滤和排序选项调用存储的记忆
使用自定义类别标记记忆
通过灵活的检索访问近期和较早的记忆

URL内容处理

从网页提取和导入内容
解析并提取 PDF 文档中的文本
检索 YouTube 视频记录
智能检测内容类型并进行相应处理

设置说明

从https://claude.ai/download安装 Claude Desktop
编辑您的 Claude Desktop 配置文件：
- Mac： ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows： %APPDATA%\Claude\claude_desktop_config.json
添加此配置：

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

获取您的 Roam API 令牌：
- 转到您的 Roam Research 图表设置
- 导航至“API 令牌”
- 点击“+新API令牌”
- 将令牌复制到您的配置中

如何使用

设置完成后，只需与 Claude 通信，并让它与您的 Roam 图表配合使用即可。Claude 将在后台使用相应的 MCP 命令。

对话示例：

创建内容：

您：“克劳德，请在我的 Roam 图表中创建一个名为‘项目创意’的新页面，其中包含一个移动应用程序创意部分。”

搜索内容：

您：“在我的 Roam 图中找到所有标有 #ProjectIdeas 且提及移动应用程序的区块。”
你：“向我展示我本周创建的所有 TODO 项。”

使用记忆系统：

你：“记住，我想使用间隔重复来学习 JavaScript。”
后来：你：“我们讨论了哪些编程学习技巧？”

使用外部内容：

您：“从此 PDF 中提取要点并将其添加到我的 Roam 图表中。”
你：“获取这个 YouTube 视频中关于生产力的文字记录。”

高级配置

默认情况下，记忆会以#[[Memories]]标签存储。要使用其他标签：

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

执照

MIT 许可证

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

该服务器使 Claude 等 AI 助手能够通过标准化界面与 Roam Research 图表进行交互，为内容创建、搜索、检索和可选内存管理提供全面的工具。

Roam Research MCP Server