漫游研究 MCP 服务器

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

它的作用

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

例如，你可以说：

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

Related MCP server: MCP Unified Server

特征

内容创作

创建具有嵌套内容和标题的新页面
将块添加到具有适当层次结构的任何页面
使用可自定义的嵌套创建结构化轮廓
使用适当的嵌套导入 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]]" }

Docker 支持

您可以在 Docker 容器中运行 Roam MCP 服务器：

构建图像

docker build -t roam-mcp .

运行容器

使用环境变量运行：

docker run -p 3000:3000 \ -e ROAM_API_TOKEN="your_api_token" \ -e ROAM_GRAPH_NAME="your_graph_name" \ roam-mcp

与 Claude Desktop 一起使用

配置 Claude Desktop 以使用容器化服务器：

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