笔记连接服务

反映MCP服务器

连接您的 反映 Claude Desktop的笔记。

先决条件

安装前，请确保：

• 反射桌面 -必须安装（但不需要运行）

  • 下载自 反射应用程序

• 克劳德桌面 -需要使用MCP服务器

  • 下载自 claude.ai

• Node.js -建议使用版本18或更高版本

  • 下载自 nodejs.org

快速开始

1.安装 reflect-mcp 包裹：

npm install reflect-mcp

2.安装服务器：

npx reflect-mcp install

3.添加到Claude桌面配置 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "reflect": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "--port", "4209", "http://localhost:3000/mcp"]
    }
  }
}

重要提示：

• 确认端口号(3000 在上面的示例中）与安装服务器时使用的端口匹配。如果使用自定义端口安装 --port，请改用该端口号。
• 添加 "--port", "4209" （使用a 每个MCP客户端的不同端口号 -例如。， "4210", "4211"等等）以避免端口冲突。每个MCP客户端都需要一个唯一的端口。

4.重新启动克劳德桌面

就是这样！第一次使用Reflect工具时，您的浏览器将打开进行身份验证。

注： 如果您看到身份验证错误，请再次尝试重新启动Claude Desktop。

使用示例

安装后，您可以让Claude读写您的笔记：

• “阅读我标记为#西班牙语的所有笔记，并创建一个包含我最大差距的学习指南笔记”

• “阅读我最近的3个每日笔记，并创建一个标记为#reflection的每周总结笔记”

• “查看标记为#work的笔记。根据我正在学习和努力的内容创建一个‘职业发展计划’笔记”

• “阅读我与[[经理]]的1:1会议记录，并创建绩效评估准备记录”

命令

reflect-mcp install [db-path]    # Install as auto-start service
reflect-mcp uninstall            # Remove auto-start service
reflect-mcp status               # Check service status
reflect-mcp [db-path]            # Run server manually

选项

例子

# Install with default settings
npx reflect-mcp install

# Install with custom database path
npx reflect-mcp install ~/custom/path/to/reflect/db

# Install with custom port
npx reflect-mcp install --port 4000

# Check if service is running
npx reflect-mcp status

# Remove auto-start
npx reflect-mcp uninstall

可用工具

• get_graphs -列出所有反射图
• get_backlinks -获取笔记的反向链接
• get_daily_notes -获取最近的每日笔记
• get_daily_note_by_date -获取特定日期的每日笔记
• get_backlinked_notes -获取大多数反向链接的笔记
• get_tags -获取所有包含使用次数的标签
• get_notes_with_tag -获取带有特定标签的笔记
• get_note -按标题获取注释
• create_note -创建新笔记

故障排除

服务器无法启动

• 检查端口3000是否可用： lsof -i :3000
• 尝试其他端口： npx reflect-mcp install --port 4000

OAuth不工作

• 安装后重新启动Claude Desktop
• 检查服务器是否正在运行： npx reflect-mcp status
• 尝试卸载并重新安装： npx reflect-mcp uninstall && npx reflect-mcp install

找不到数据库

• 确保已安装Reflect Desktop
• 验证默认位置是否存在数据库路径
• 尝试指定自定义路径： npx reflect-mcp install /path/to/db

演示：

https://www.loom.com/share/455b1d3eb7184bdea1ae4e8d5904fc53

许可证

麻省理工学院