AI导哈

Roam Research MCP服务器

Roam Research MCP服务器是一个连接Claude和其他AI助手到你的Roam Research知识图谱的桥梁，支持内容创建、搜索检索、记忆系统和URL内容处理等功能。

  • by PhiloSolares
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 philosolares/roam-mcp

使用说明

漫游研究MCP服务器

一个模型上下文协议（MCP）服务器，将Claude和其他AI助手连接到您的漫游研究图。

这有什么作用

该服务器充当AI助手和您的漫游研究数据库之间的桥梁。设置后，您只需让Claude处理您的漫游数据即可，无需编码。

例如，你可以说：

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

特性

内容创建

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

搜索和检索

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

存储器系统

  • 存储信息，以便克劳德在对话中记住
  • 使用过滤和排序选项回忆存储的记忆
  • 用自定义类别标记记忆
  • 通过灵活检索访问最近和较旧的记忆

URL内容处理

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

安装说明

  1. 从以下位置安装Claude Desktop https://claude.ai/download

  2. 编辑您的Claude Desktop配置文件：

    • 雨衣： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户： %APPDATA%\Claude\claude_desktop_config.json

  3. 添加此配置：

{
  "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>"
      }
    }
  }
}
  1. 获取您的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许可证

相关 MCP