PhiloSolares

@PhiloSolares/roam-mcp

0 Stars 329 次浏览 PhiloSolares 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "roam-helper": {
      "args": [
        "run",
        "--rm",
        "-p",
        "3000:3000",
        "-e",
        "ROAM_API_TOKEN=your_token",
        "-e",
        "ROAM_GRAPH_NAME=your_graph",
        "roam-mcp"
      ],
      "command": "docker",
      "env": {}
    }
  }
}

服务介绍

Roam Research MCP 服务器

这是一个模型上下文协议（MCP）服务器，它将Claude及其他AI助手与您的Roam Research图谱连接起来。

功能介绍

该服务器充当AI助手和您的Roam Research数据库之间的桥梁。设置完成后，您可以直接要求Claude处理您的Roam数据——无需编写代码。

例如，您可以说：

"将这些会议笔记添加到今天的每日笔记中"
"在我的Roam图谱中搜索带有#ProjectIdeas标签的块"
"在Roam中创建一个名为'项目规划'的新页面"
"找到我本月创建的所有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%Claudeclaude_desktop_config.json
添加以下配置：

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命令。

示例对话：

创建内容：

您：“Claude，请在我的Roam图谱中创建一个名为'项目想法'的新页面，并包含一个移动应用想法的部分。”

搜索内容：

您：“找到我的Roam图谱中标记为#ProjectIdeas且提及移动应用的所有块。”

您：“显示我本周创建的所有TODO项。”

使用记忆系统：

您：“记住我想用间隔重复法学习JavaScript。”

后来：
您：“我们讨论了哪些编程学习技巧？”

处理外部内容：

您：“从这个PDF中提取要点并添加到我的Roam图谱中。”

您：“获取这段关于生产力的YouTube视频的字幕。”

高级配置

默认情况下，记忆被存储时带有#[[Memories]]标签。要使用不同的标签：

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

Docker支持

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

构建镜像

bash
docker build -t roam-mcp .

运行容器

带环境变量运行：

bash
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 以使用容器化的服务器：

json
{
"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 许可证

查看源码项目主页