Reflect笔记交互服务器

一个远程MCP服务器,用于通过OAuth认证使AI助手(如Claude)与Reflect笔记进行交互。

  • by John42506176Linux
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 John42506176Linux/Reflect.app-MCP

使用说明

反映MCP服务器

遥控器 MCP服务器 为了 反映 这使得像Claude这样的人工智能助手能够通过OAuth身份验证与您的Reflect笔记进行交互。

可用工具

  • get_reflect_graphs:获取您的帐户可访问的所有Reflect图表的列表
  • append_to_reflect_daily_notes:将内容添加到特定Reflect图中的每日笔记中
    • graph_id:图形标识符
    • content:要附加的文本/标记
    • date:ISO 8601格式的日期(YYYY-MM-DD)——使用用户的本地日期以避免时区问题

本地设置

1.创建Reflect OAuth应用程序

  1. 转到您的Reflect设置并创建OAuth应用程序
  2. 注意你的 客户端ID 和 客户端密钥
  3. 根据部署设置重定向URL:
    • 远程: https://your-worker.your-subdomain.workers.dev/oauth/callback
    • 本地: http://localhost:3000/oauth/callback

2.配置环境变量

创建一个 .dev.vars 本地开发文件:

cp .dev.vars.example .dev.vars

然后填写您的凭据:

REFLECT_CLIENT_ID=your_reflect_client_id
REFLECT_CLIENT_SECRET=your_reflect_client_secret
COOKIE_ENCRYPTION_KEY=your_random_string

生成安全加密密钥:

openssl rand -hex 32

本地运行

1.安装依赖项

npm install

2.启动开发服务器

npm run dev

服务器将在以下时间启动 http://localhost:8787.

3.配置Claude Desktop以供本地使用

打开克劳德桌面并导航到 设置→ 开发者→ 编辑配置.

更新配置以指向本地服务器:

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

重新启动克劳德桌面。将打开一个浏览器窗口进行Reflect OAuth身份验证。授予访问权限后,工具将可用。

备注:确保您的Reflect OAuth应用程序具有 http://localhost:8787/oauth/callback 作为允许的重定向URL。

MCP检验员测试

您可以使用 MCP检查员:

npx @modelcontextprotocol/inspector@latest

输入您的服务器URL(http://localhost:8787/sse 本地或您部署的URL)并连接。

许可证

麻省理工学院