漫游研究MCP服务器
一个模型上下文协议（MCP）服务器，将Claude和其他AI助手连接到您的漫游研究图。
这有什么作用
该服务器充当AI助手和您的漫游研究数据库之间的桥梁。设置后，您只需让Claude处理您的漫游数据即可，无需编码。
例如，你可以说：
- “将这些会议笔记添加到Roam中的每日笔记中”
- “在我的漫游图中搜索标记有#ProjectIdeas的块”
- “在漫游中创建一个名为“项目规划”的新页面”
- “查找我本月创建的所有TODO项目”
特性
内容创建
- 创建具有嵌套内容和标题的新页面
- 向任何具有适当层次结构的页面添加块
- 使用可定制的嵌套创建结构化轮廓
- 导入带有适当嵌套的markdown
- 添加具有自动todo状态的todo项目
- 单独或批量更新现有内容
- 使用图案变换修改块内容
搜索和检索
- 按标题、文本或标签查找页面和块
- 使用筛选选项搜索TODO/DONE项目
- 查找最近修改的内容
- 搜索块引用并探索块层次结构
- 按创建或修改日期搜索
- 在块中导航父子关系
- 执行自定义数据日志查询以满足高级需求
存储器系统
- 存储信息，以便克劳德在对话中记住
- 使用过滤和排序选项回忆存储的记忆
- 用自定义类别标记记忆
- 通过灵活检索访问最近和较旧的记忆
URL内容处理
- 从网页中提取和导入内容
- 从PDF文档中解析和提取文本
- 检索YouTube视频转录
- 智能检测内容类型并相应地进行处理
安装说明
- 从以下位置安装Claude Desktop
- 编辑您的Claude Desktop配置文件：
- 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 添加此配置：
{
"mcpServers": {
"roam-helper": {
"command": "uvx",
"args": ["git+https://github.com/PhiloSolares/roam-mcp.git"],
"env": {
"ROAM_API_TOKEN": "",
"ROAM_GRAPH_NAME": ""
}
}
}
}- 获取您的Roam API令牌：
- 转到您的漫游研究图设置 - 导航到“API令牌” - 点击“+新建API代币” - 将令牌复制到您的配置中
如何使用
设置完成后，只需与Claude聊天，并让它使用您的漫游图。Claude将在幕后使用适当的MCP命令。
对话示例：
创建内容：
你：“克劳德，请在我的漫游图中创建一个名为‘项目创意’的新页面，其中有一个移动应用创意部分。”
搜索内容：
你：“在我的漫游图中找到所有标记有#ProjectIdeas的块，这些块也提到了移动应用程序。” 你：“显示我本周创建的所有TODO项目。”
使用存储系统：
你：“记住，我想用间隔重复来学习JavaScript。” 稍后： 你：“我们讨论过哪些编程学习技巧？”
处理外部内容：
你：“从这个PDF中提取要点，并将其添加到我的漫游图中。” 你：“从这段关于生产力的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": {}
}
}
}许可证
MIT许可证