项目介绍
Roam Research MCP Server
这是一个模型上下文协议（MCP）服务器，用于连接Claude和其他AI助手到您的Roam Research图数据库。
功能概述
此服务器充当AI助手与您的Roam Research数据库之间的桥梁。设置完成后，您可以简单地要求Claude处理您的Roam数据——无需编写代码。
例如，您可以这样说：
- "将这些会议记录添加到今天在Roam中的日常笔记中"
- "在我的Roam图中搜索标记为#ProjectIdeas的块"
- "在Roam中创建一个名为'Project Planning'的新页面"
- "查找我本月创建的所有TODO事项"
特性
内容创作
- 创建带有嵌套内容和标题的新页面
- 按照适当层次结构向任何页面添加块
- 创建可自定义嵌套的结构化大纲
- 导入具有适当嵌套的Markdown
- 添加自动TODO状态的待办事项
- 单独或批量更新现有内容
- 使用模式转换修改块内容
搜索与检索
- 根据标题、文本或标签查找页面和块
- 使用过滤选项搜索TODO/DONE事项
- 查找最近修改的内容
- 搜索块引用并探索块层次结构
- 按创建或修改日期搜索
- 导航块的父子关系
- 执行自定义Datalog查询以满足高级需求
记忆系统
- 存储信息供Claude跨对话记忆
- 使用过滤和排序选项召回存储的记忆
- 使用自定义类别标记记忆
- 灵活检索近期和较旧的记忆
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
- Mac:
-
添加以下配置：
{
"m使用Claude Desktop配置文件中的mcpServers部分来添加以下配置：
"mcpServers": {
"roam-helper": {
"command": "uvx",
"args": ["git+https://github.com/PhiloSolares/roam-mcp.git"],
"env": {
"ROAM_API_TOKEN": "<您的Roam API令牌>",
"ROAM_GRAPH_NAME": "<您的Roam图名称>"
}
}
}
}
- 获取您的Roam API令牌：
- 转到您的Roam Research图设置
- 导航至“API令牌”
- 点击“+ 新建API令牌”
- 将令牌复制到您的配置中
如何使用
设置完成后，只需与Claude聊天，并要求它处理您的Roam图。Claude将在后台使用适当的MCP命令。
示例对话：
创建内容：
您："Claude，请在我的Roam图中创建一个名为'Project Ideas'的新页面，并包含一个关于移动应用想法的部分。"
搜索内容：
您："查找我的Roam图中标记为#ProjectIdeas且提到移动应用的所有块。"
您："显示我本周创建的所有TODO事项。"
使用记忆系统：
您："记住我想使用间隔重复法学习JavaScript。"
后来： 您："我们讨论过哪些编程学习技巧？"
处理外部内容：
您："从这个PDF中提取主要观点并将其添加到我的Roam图中。"
您："获取这段关于生产力的YouTube视频字幕。"
高级配置
默认情况下，记忆被存储并标记为#[[Memories]]。要使用不同的标签：
"env": {
"ROAM_API_TOKEN": "您的令牌",
"ROAM_GRAPH_NAME": "您的图",
"MEMORIES_TAG": "#[[Claude/Memories]]"
}
Docker支持
您可以在Docker容器中运行Roam MCP服务器：
构建镜像
docker build -t roam-mcp .
运行容器
使用环境变量运行：
docker run -p 3000:3000 \
-e ROAM_API_TOKEN="您的API令牌" \
-e ROAM_GRAPH_NAME="您的图名称" \
roam-mcp
与Claude Desktop配合使用
配置Claude Desktop以使用容器化的服务器：
{
"mcpServers": {
"roam-helper": {
"command": "docker",
"args": ["run", "--rm", "-p", "3000:3000",
"-e", "ROAM_API_TOKEN=您的令牌",
"-e", "ROAM_GRAPH_NAME=您的图",
"roam-mcp"],
"env": {}
}
}
}
许可证
MIT许可证